Quickstart

Below are the basic steps to get started with the ShortGenius API:

1

Sign Up & Retrieve API Token

1. Sign up for a ShortGenius account at https://shortgenius.com.

2. Go to the API keys page to retrieve your API token.

3. Keep this token secure! You'll use it for authenticating API calls.

2

Test the Health Endpoint

Let's ensure everything is up and running with the /health endpoint.

curl --request GET \
  --url "https://shortgenius.com/api/v1/health"

Expected Response:

{
  "status": "ok"
}

3

Make Your First Authorized Request

Add your token to the Authorization header:

curl --request GET \
  --url "https://shortgenius.com/api/v1/music/genres" \
  --header "Authorization: Bearer YOUR_API_TOKEN"

If your token is valid, you'll receive a JSON list of available music genres:

[
  {
    "name": "Classical",
    "recommended_for_locales": [...]
  },
  ...
]

This quickstart is enough to prove your token works and that the API is reachable. In the next sections, we'll dive deeper into the available endpoints and show you how to create videos, images, audio, and more.

SDK Quickstarts

For a more streamlined development experience, check out our official SDKs:

TypeScript QuickstartPython Quickstart

---

Next Steps Now that you've tested the waters, proceed to Authentication & Essentials.