Queue AI Product Videos with estudjo: Duration and Prompts

estudjo can generate short cinematic product videos from a single product photo. Video generation uses the same POST /generate endpoint as images — the model you specify determines whether image or video logic runs.

Key Differences from Image Generation

Before sending a video request, note these differences from the image flow:

duration is required — supported values are "5", "8", or "15" (plain number strings, no unit suffix)
prompt is recommended — pass a direct prompt string instead of a scene for the most control over the output
prompt takes priority — when prompt is present, any scene or sceneId value is ignored entirely
category is optional — for video models it falls back to the model-wide default when omitted

Required Fields

Field	Type	Description
`model`	string	Video model identifier (e.g. `estudjo/economic-video`)
`aspect-ratio`	string	e.g. `1:1`, `16:9`
`resolution`	string	e.g. `480P`
`duration`	string	`"5"`, `"8"`, or `"15"`
`image_url`	string	Publicly accessible product image
`prompt` or `scene`	string	Either a direct prompt string or a scene UUID

If both prompt and scene/sceneId are absent from the request body, the API returns 400 invalid_input.

Example Request

The example below uses a direct prompt string — the recommended approach for video generation.

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",
    "category": "womens-clothing",
    "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": "619de1fbf0299c749efecedd7eb15942"
  }
}

Poll GET /status with the returned task_id to track the generation and retrieve the video URL once complete.

Error Reference

Code	HTTP	Cause
`invalid_input`	400	Missing required field, bad `aspect-ratio` or `resolution` value, invalid `duration` (only `"5"`, `"8"`, `"15"` accepted), or both `prompt` and `scene`/`sceneId` are absent
`not_found`	404	Unknown model or scene
`insufficient_credits`	402	Account balance too low to queue the generation
`provider_error`	502	Upstream AI provider failed — retry after a short delay

Get Started

Core Concepts

How-To Guides

Reference

Queue AI Product Videos with estudjo: Duration and Prompts

Key Differences from Image Generation

Required Fields

Example Request

Response

Error Reference

Next Steps

Poll for Status

Image Generation

​Key Differences from Image Generation

​Required Fields

​Example Request

​Response

​Error Reference

​Next Steps

Poll for Status

Image Generation

Key Differences from Image Generation

Required Fields

Example Request

Response

Error Reference

Next Steps