POST /generate — Queue an Image or Video Generation

POST /generate queues an AI generation job. The model you specify determines whether image or video logic runs. The endpoint is asynchronous — it returns a task_id immediately; use GET /status to track completion. POST https://v1.api.estudjo.com/generate

string

required

Your estudjo API key.

Image
Video

Request body

string

required

Model identifier (e.g. estudjo/eco).

string

required

Category slug (e.g. womens-clothing).

string

required

Output aspect ratio (e.g. 1:1).

string

required

Output resolution (e.g. 1K).

string

required

Scene UUID..

string

required

Publicly accessible URL of the product image to use as the generation source.

object

Flat object of string:string pairs. Each entry is prepended to the prompt as a "Title Case Key: Title Case Value" line, in key order. Omit the field, pass null, or pass {} to add no extra data.

Example request

curl -X POST https://v1.api.estudjo.com/generate \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "estudjo/eco",
    "category": "womens-clothing",
    "aspect-ratio": "1:1",
    "resolution": "1K",
    "scene": "59b4a671-1b90-453e-92c3-a28ceee177af",
    "image_url": "https://static.example.com/thumb/product-86713.jpg",
    "additional_data": { "product_name": "White Long Dress" }
  }'

Request body

string

required

Video model identifier (e.g. estudjo/economic-video).

string

required

Output aspect ratio (e.g. 1:1).

string

required

Output resolution (e.g. 480P).

string

required

Clip duration in seconds. Accepted values: 5, 8, or 15.

string

required

Publicly accessible URL of the product image to use as the generation source.

string

Direct text prompt describing the desired video output. When prompt is present, scene and sceneId are never consulted. Required if neither scene nor sceneId is provided.

string

Scene UUID. Used only when prompt is absent. Provide either scene or sceneId — one is required if prompt is not supplied.

string

Alternative field name for the scene UUID. Interchangeable with scene when prompt is absent.

string

Category slug. Falls back to the model’s default category if omitted.

If prompt is present, scene and sceneId are ignored entirely — the prompt takes full precedence.

Example request

curl -X POST https://v1.api.estudjo.com/generate \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "estudjo/economic-video",
    "aspect-ratio": "1:1",
    "resolution": "480P",
    "duration": "5",
    "prompt": "confident fashion model showcasing the outfit, slow cinematic camera pan",
    "image_url": "https://static.example.com/thumb/product-86713.jpg"
  }'

Response

{
  "success": true,
  "data": {
    "status": "queued",
    "task_id": "6bfd652d4c31261ffb8ed3424ac2775e"
  }
}

boolean

true when the request was accepted and the job was queued.

object

Show data

string

Always "queued" on a successful response — the job has been accepted and is waiting to run.

string

Unique identifier for this generation job. Save this value and pass it to GET /status to poll for results.

Errors

Code	HTTP	Cause
`invalid_input`	400	Missing required field, invalid `aspect-ratio`/`resolution`/`duration`, category not linked to scene, or `additional_data` values are not flat strings
`not_found`	404	Unknown model, or the specified scene doesn’t exist or doesn’t belong to your account
`insufficient_credits`	402	Your credit balance is too low to queue this job
`provider_error`	502	The upstream AI provider returned an error. For video generations, this can also indicate that the merged prompt (scene text + additional data) exceeded the provider’s length limit

Health

API Keys

Wallet

Generations

Scenes

POST /generate — Queue an Image or Video Generation

Request body

Example request

Request body

Example request

Response

Errors

​Request body

​Example request

​Request body

​Example request

​Response

​Errors

Request body

Example request

Request body

Example request

Response

Errors