Skip to main content
POST
Generate media with AI

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Body

application/json

Start generating media from a prompt

prompt
string
required

What to generate. Up to 4000 characters for an image, 2000 for a sound effect.

Minimum string length: 1
Example:

"A watercolor illustration of a lighthouse at dawn"

type
enum<string>
required

The kind of media to generate

Available options:
image,
sound-effect
Example:

"image"

model
enum<string>

For image only: which GPT Image 2.5 model to use. sunburst (default) is the most capable and follows reference images most precisely; flare is faster.

Available options:
sunburst,
flare
Example:

"flare"

referenceSourceId
string

For image only: the sourceId of an image source to guide the generation — from POST /v1/sources (kind: "image") after uploading the bytes, or an image library item's sourceId.

Example:

"su_abc123def456"

Response

Accepted

The generation that was started, plus the weekly allowance

generation
object
required

An AI media generation and, once finished, its library item

limit
integer
required

The caller's weekly AI generation allowance for this media type, which depends on the plan

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

20

remaining
integer
required

Generations left in the current week, after this one

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

19

resetAt
number
required

When the weekly allowance resets, as a millisecond epoch

Example:

1760000000000

Last modified on October 6, 2026