Choose a generation task and model

Every request starts with a task. Use image.create, image.edit, video.create, or a supported processing task to describe the result you need. Then choose one of that task's available models when the task requires it.

Read the task before building input

GET /v1/tasks returns each task's availability, models, variants, input schemas, defaults, and output schema. GET /v1/models provides the inverse view: each model and the tasks it supports.

For a model-backed task, send both task and model. For a model-less task, omit model entirely. Do not send null.

Apply defaults deliberately

Defaults are valid starting values, not hidden request fields. Send explicit values when dimensions, duration, resolution, or processing thresholds matter to your integration.

Understand social search context

social.search applies a US search context where the selected platform integration supports country selection. TikTok searches are pinned to the US. The current Instagram Reels and YouTube Shorts integrations do not accept a country or locale, so those searches use the integration's default context and do not guarantee US-localized results.

See the generated models and tasks reference for complete current schemas and prices.