AI Studio API
发起生成任务
使用模型 ID 和 payload 提交 AI Studio 生成请求。
API Playground
直接向当前站点发送真实请求，并立即查看 HTTP 响应。
响应结果
发送请求后，响应内容会显示在这里。POST
/api/ai-studio/execute发起新的 AI Studio 生成任务。请求体包含 modelId、isPublic、payload。视频或图片能力取决于所选模型 schema。
请求头
Authorization: Bearer YOUR_API_KEYContent-Type: application/json请求参数
| 参数名 | 类型 | 必填 | 默认值 | 可选值 | 说明 |
|---|---|---|---|---|---|
| modelId | string | 是 | - | video:grok-imagine-text-to-video, video:grok-imagine-image-to-video, video:grok-imagine-video-upscale, video:grok-imagine-video-extend, video:grok-imagine-video-1-5-preview, video:fal-xai-grok-imagine-video-text-to-video, video:fal-xai-grok-imagine-video-image-to-video, video:fal-xai-grok-imagine-video-v1-5-image-to-video, video:fal-xai-grok-imagine-video-reference-to-video, video:fal-xai-grok-imagine-video-edit-video, video:am-omni-flash-ext, video:gemini-omni-video, video:gemini-omni-character, video:gemini-omni-audio, video:bytedance-seedance-2, video:bytedance-seedance-2-0-fast, video:bytedance-seedance-2-0-mini, 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:bytedance-seedance-1-5-pro, 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:bytedance-v1-pro-text-to-video, video:bytedance-v1-pro-image-to-video, video:bytedance-v1-lite-text-to-video, video:bytedance-v1-lite-image-to-video, video:bytedance-v1-pro-fast-image-to-video, video:veo-3.1-lite, video:veo-3.1-fast, video:veo-3.1-quality, video:extend-veo3-1-video, video:get-veo3-1-1080p-video, video:get-veo3-1-4k-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:sora2-text-to-video-standard, video:sora2-image-to-video-standard, video:sora2-pro-text-to-video, video:sora2-pro-image-to-video, video:sora2-pro-storyboard, video:sora2-official, 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:kling-3-0, video:kling-3-0-motion-control, video:kling-v3-turbo-text-to-video, video:kling-v3-turbo-image-to-video, video:kling-2-6-text-to-video, video:kling-2-6-image-to-video, video:kling-2-6-motion-control, video:kling-v2-5-turbo-text-to-video-pro, video:kling-v2-5-turbo-image-to-video-pro, video:kling-v2-1-master-text-to-video, video:kling-v2-1-master-image-to-video, video:kling-v2-1-pro, video:kling-v2-1-standard, video:kling-ai-avatar-standard, video:kling-ai-avatar-pro, 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-o1-image-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:wan-2-7-text-to-video, video:wan-2-7-image-to-video, video:wan-2-7-video-edit, video:wan-2-7-reference-to-video, video:wan-2-6-text-to-video, video:wan-2-6-image-to-video, video:wan-2-6-video-to-video, video:wan-2-5-text-to-video, video:wan-2-5-image-to-video, video:wan-text-to-video, video:wan-image-to-video, video:wan-2-2-a14b-speech-to-video-turbo, video:wan-animate-move, video:wan-animate-replace, 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:happyhorse-text-to-video, video:happyhorse-image-to-video, video:happyhorse-reference-to-video, video:happyhorse-1-1-text-to-video, video:happyhorse-1-1-image-to-video, video:happyhorse-1-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-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:hailuo-standard-text-to-video, video:hailuo-standard-image-to-video, video:hailuo-pro-text-to-video, video:hailuo-pro-image-to-video, video:hailuo-2-3-standard-image-to-video, video:hailuo-2-3-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-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:generate-ai-video, video:generate-aleph-video, video:bytedance-seedance-2-5, video:minimax-h3-text-to-video, video:minimax-h3-image-to-video, video:minimax-h3-reference-to-video, video:pixverse-v6-text-to-video, video:pixverse-v6-image-to-video, video:pixverse-v6-first-last-frame-transition, video:pixverse-v6-fusion-reference-to-video, video:pixverse-v6-video-extension, video:meta-muse-text-to-video, video:meta-muse-image-to-video, video:meta-muse-reference-to-video, image:google-nano-banana-pro, image:google-nano-banana-2, image:google-nano-banana-2-lite, image:fal-fal-ai-gemini-3-1-flash-image-preview, image:fal-fal-ai-gemini-3-1-flash-image-preview-edit, 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-google-nano-banana-2-lite, image:gpt-image-2-text-to-image, image:gpt-image-2-image-to-image, 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:seedream5-0-lite-text-to-image, image:seedream5-0-lite-image-to-image, image:seedream5-0-pro-text-to-image, image:seedream5-0-pro-image-to-image, image:seedream-5-0-pro-layer-decomposition, image:seedream4-5-text-to-image, image:seedream4-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:qwen2-text-to-image, image:qwen2-image-edit, image:fal-fal-ai-qwen-image-2-text-to-image, image:fal-fal-ai-qwen-image-2-edit, image:grok-imagine-text-to-image, image:grok-imagine-image-to-image, 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:wan-2-7-image, image:wan-2-7-image-pro, 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:qwen3-text-to-image, image:qwen3-image-to-image, image:qwen3-pro-text-to-image, image:qwen3-pro-image-to-image, image:meta-muse-text-to-image, image:meta-muse-image-edit, image:meta-muse-multi-reference-image | 你选择的视频模型 ID。 |
| isPublic | boolean | 否 | true | - | 是否公开展示这次生成结果。默认 true。 |
| payload | object | 是 | - | - | 生成时提交的主要输入内容，不同模型的嵌套字段会不同。查看「Dynamic payload fields by model」 |
请求示例
curl -X POST "https://freesoragenerator.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"
}
}
}'响应示例
{
"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": {}
}
}错误示例
{
"success": false,
"error": "User not authenticated"
}生成时提交的主要输入内容，不同模型的嵌套字段会不同。 查看「Dynamic payload fields by model」