AI Studio API
Create a generation
Submit an AI Studio generation request with a model and payload.
API playground
Send a real request to this site and inspect the HTTP response immediately.
Response
Send a request to view its response here.POST
/api/ai-studio/executeStart a new generation task. The request uses modelId, isPublic, and payload.
Request Headers
Authorization: Bearer YOUR_API_KEYContent-Type: application/jsonRequest Parameters
| Name | Type | Required | Default | Options | Description |
|---|---|---|---|---|---|
| modelId | string | Yes | - | video:fal-bytedance-seedance-2-5-text-to-video, video:fal-bytedance-seedance-2-5-image-to-video, video:fal-bytedance-seedance-2-5-reference-to-video, video:fal-minimax-h3-max-text-to-video, video:fal-minimax-h3-max-image-to-video, video:fal-minimax-h3-max-reference-to-video, video:fal-fal-ai-veo3-1, video:fal-fal-ai-veo3-1-fast, video:fal-fal-ai-veo3-1-image-to-video, video:fal-fal-ai-veo3-1-fast-image-to-video, video:fal-fal-ai-veo3, video:fal-fal-ai-veo3-fast, video:fal-fal-ai-sora-2-text-to-video, video:fal-fal-ai-sora-2-image-to-video, video:fal-fal-ai-sora-2-text-to-video-pro, video:fal-fal-ai-sora-2-image-to-video-pro, video:fal-fal-ai-sora-2-video-to-video-remix, video:fal-fal-ai-kling-video-o3-pro-text-to-video, video:fal-fal-ai-kling-video-o3-standard-text-to-video, video:fal-fal-ai-kling-video-o3-pro-image-to-video, video:fal-fal-ai-kling-video-o3-standard-image-to-video, video:fal-fal-ai-kling-video-o3-pro-video-to-video-reference, video:fal-fal-ai-kling-video-o3-standard-video-to-video-reference, video:fal-fal-ai-kling-video-o3-pro-video-to-video-edit, video:fal-fal-ai-kling-video-o3-standard-video-to-video-edit, video:fal-fal-ai-kling-video-v3-pro-text-to-video, video:fal-fal-ai-kling-video-v3-standard-text-to-video, video:fal-fal-ai-kling-video-v3-pro-image-to-video, video:fal-fal-ai-kling-video-v3-standard-image-to-video, video:fal-fal-ai-kling-video-v3-4k-image-to-video, video:fal-fal-ai-kling-video-v3-4k-text-to-video, video:fal-fal-ai-kling-video-v2-6-pro-text-to-video, video:fal-fal-ai-kling-video-v2-6-pro-image-to-video, video:fal-fal-ai-kling-video-v2-6-standard-motion-control, video:fal-fal-ai-kling-video-o1-image-to-video, video:fal-xai-grok-imagine-video-v1-5-image-to-video, video:fal-xai-grok-imagine-video-text-to-video, video:fal-xai-grok-imagine-video-image-to-video, video:fal-xai-grok-imagine-video-reference-to-video, video:fal-xai-grok-imagine-video-edit-video, video:fal-google-gemini-omni-flash-v1-1-text-to-video, video:fal-google-gemini-omni-flash-v1-1-image-to-video, video:fal-google-gemini-omni-flash-v1-1-reference-to-video, video:fal-google-gemini-omni-flash-v1-1-edit, video:am-omni-flash-ext, video:fal-bytedance-seedance-2-0-text-to-video, video:fal-bytedance-seedance-2-0-fast-text-to-video, video:fal-bytedance-seedance-2-0-image-to-video, video:fal-bytedance-seedance-2-0-fast-image-to-video, video:fal-bytedance-seedance-2-0-reference-to-video, video:fal-bytedance-seedance-2-0-fast-reference-to-video, video:fal-bytedance-seedance-2-0-mini-text-to-video, video:fal-bytedance-seedance-2-0-mini-image-to-video, video:fal-bytedance-seedance-2-0-mini-reference-to-video, video:fal-alibaba-wan-3-0-text-to-video, video:fal-alibaba-wan-3-0-image-to-video, video:fal-alibaba-wan-3-0-reference-to-video, video:fal-alibaba-wan-3-0-prime-text-to-video, video:fal-alibaba-wan-3-0-prime-image-to-video, video:fal-alibaba-wan-3-0-prime-reference-to-video, video:fal-fal-ai-wan-v2-7-text-to-video, video:fal-fal-ai-wan-v2-7-image-to-video, video:fal-fal-ai-wan-v2-7-reference-to-video, video:fal-fal-ai-minimax-hailuo-2-3-standard-text-to-video, video:fal-fal-ai-minimax-hailuo-2-3-standard-image-to-video, video:fal-fal-ai-minimax-hailuo-2-3-pro-text-to-video, video:fal-fal-ai-minimax-hailuo-2-3-pro-image-to-video, video:fal-fal-ai-minimax-hailuo-2-3-fast-standard-image-to-video, video:fal-fal-ai-minimax-hailuo-2-3-fast-pro-image-to-video, video:fal-fal-ai-minimax-hailuo-02-standard-text-to-video, video:fal-fal-ai-minimax-hailuo-02-standard-image-to-video, video:fal-fal-ai-minimax-hailuo-02-pro-text-to-video, video:fal-fal-ai-minimax-hailuo-02-pro-image-to-video, video:fal-fal-ai-minimax-hailuo-02-fast-image-to-video, video:fal-alibaba-happy-horse-v1-1-text-to-video, video:fal-alibaba-happy-horse-v1-1-image-to-video, video:fal-alibaba-happy-horse-v1-1-reference-to-video, video:fal-alibaba-happy-horse-text-to-video, video:fal-alibaba-happy-horse-image-to-video, video:fal-alibaba-happy-horse-reference-to-video, video:fal-fal-ai-bytedance-seedance-v1-5-pro-text-to-video, video:fal-fal-ai-bytedance-seedance-v1-5-pro-image-to-video, video:meta-muse-text-to-video, video:meta-muse-image-to-video, video:meta-muse-reference-to-video, image:fal-fal-ai-gemini-3-1-flash-image-preview, image:fal-fal-ai-gemini-3-1-flash-image-preview-edit, image:fal-google-nano-banana-2-lite, image:fal-fal-ai-gemini-3-pro-image-preview, image:fal-fal-ai-gemini-3-pro-image-preview-edit, image:fal-fal-ai-nano-banana, image:fal-fal-ai-nano-banana-edit, image:fal-openai-gpt-image-2-5-flare-text-to-image, image:fal-openai-gpt-image-2-5-flare-edit, image:fal-openai-gpt-image-2-5-sunburst-text-to-image, image:fal-openai-gpt-image-2-5-sunburst-edit, image:ama-gpt-image-2, image:fal-openai-gpt-image-2, image:fal-openai-gpt-image-2-edit, image:fal-fal-ai-gpt-image-1-5, image:fal-fal-ai-gpt-image-1-5-edit, image:fal-fal-ai-bytedance-seedream-v5-lite-text-to-image, image:fal-fal-ai-bytedance-seedream-v5-lite-edit, image:fal-bytedance-seedream-v5-pro-text-to-image, image:fal-bytedance-seedream-v5-pro-edit, image:fal-fal-ai-bytedance-seedream-v4-5-text-to-image, image:fal-fal-ai-bytedance-seedream-v4-5-edit, image:fal-xai-grok-imagine-image-v2-0-text-to-image, image:fal-xai-grok-imagine-image-v2-0-edit, image:fal-xai-grok-imagine-image, image:fal-xai-grok-imagine-image-edit, image:fal-xai-grok-imagine-image-quality-text-to-image, image:fal-xai-grok-imagine-image-quality-edit, image:fal-fal-ai-wan-v2-7-text-to-image, image:fal-fal-ai-wan-v2-7-edit, image:fal-fal-ai-wan-v2-7-pro-text-to-image, image:fal-fal-ai-wan-v2-7-pro-edit, image:fal-fal-ai-qwen-image-2-text-to-image, image:fal-fal-ai-qwen-image-2-edit, image:meta-muse-text-to-image, image:meta-muse-image-edit, image:meta-muse-multi-reference-image | Model ID for the video style/version you choose. |
| isPublic | boolean | No | true | - | Whether this result can be shown publicly. Default is true. |
| payload | object | Yes | - | - | Main input data for generation. Nested fields change with the selected model.See Dynamic payload fields by model |
Request
curl -X POST "https://sdanceai.com/api/ai-studio/execute" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"modelId": "video:sora2-text-to-video-standard",
"isPublic": true,
"payload": {
"model": "video:sora2-text-to-video-standard",
"input": {
"prompt": "A cinematic video of a cat walking in the rain"
}
}
}'Response Example
{
"success": true,
"data": {
"modelId": "video:sora2-text-to-video-standard",
"generationId": "b6a7f5c4-8a7c-4e2b-8cf6-6b8d9b3d8d21",
"reservedCredits": 20,
"taskId": "provider-task-id",
"state": "queued",
"raw": {},
"selectedPricing": {}
}
}Error Example
{
"success": false,
"error": "User not authenticated"
}Main input data for generation. Nested fields change with the selected model. See Dynamic payload fields by model