Authentication - GENGEN API

GENGEN API requests use bearer-token authentication.

Create a key

Sign in to the GENGEN Dashboard.
Open API Keys.
Create a key and copy it immediately.

Keys begin with gengen_live_. The complete secret is shown only when the key is created.

Send the key

Include the key in the Authorization header:

curl https://gengen.farm/api/gengen/v1/contents/generations/tasks \
  --header 'Authorization: Bearer gengen_live_xxxxxxxxxxxxxxxx'

Treat API keys like passwords. Do not put them in browser code, mobile apps, public repositories, documentation examples, or client-side environment variables.

Retrieve a video task with the same API key that created it. A replacement key in the same workspace can list persisted tasks but cannot retrieve a task created by the previous key.

Server-side configuration

Keep the key in a server-side secret manager or environment variable:

export GENGEN_API_KEY="gengen_live_xxxxxxxxxxxxxxxx"

const response = await fetch(
  "https://gengen.farm/api/gengen/v1/contents/generations/tasks",
  {
    headers: {
      Authorization: `Bearer ${process.env.GENGEN_API_KEY}`,
    },
  },
);

import os
import requests

response = requests.get(
    "https://gengen.farm/api/gengen/v1/contents/generations/tasks",
    headers={"Authorization": f"Bearer {os.environ['GENGEN_API_KEY']}"},
)

Authentication errors

HTTP status	Error code	Meaning
`401`	`gengen.auth_required`	The bearer token is missing.
`401`	`gengen.invalid_bearer`	The token is not a valid GENGEN API key.
`401`	`gengen.api_key_invalid`	The key cannot be found or verified.
`403`	`gengen.api_key_revoked`	The key has been revoked or disabled.
`403`	`gengen.api_key_expired`	The key has expired.

See Errors for the complete response shape.

​Create a key

​Send the key

​Server-side configuration

​Authentication errors

Create a key

Send the key

Server-side configuration

Authentication errors