ドキュメントメニュー
AI Studio API

生成タスクを作成

モデル ID と payload を使って AI Studio の生成を開始します。

API Playground

このサイトへ実際のリクエストを送信し、HTTP レスポンスを確認できます。

POST
POST

同一サイトの /api/* パスのみ呼び出せます。

空欄の場合は現在のブラウザーセッションを使用します。Key は保存されません。

これは実際の生成リクエストです。アカウントのクレジットを消費する場合があります。

レスポンス
リクエストを送信すると、ここにレスポンスが表示されます。
POST/api/ai-studio/execute

AI Studio 生成リクエストを送信します。リクエストボディは AIVideoStudio.tsx が送信する modelId、isPublic、payload と同じ形です。

Request Headers

Authorization: Bearer YOUR_API_KEYContent-Type: application/json

Request Parameters

NameTypeRequiredDefaultOptionsDescription
modelIdstringYes-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選択した動画モデルの ID です。
isPublicbooleanNotrue-生成結果を公開するかどうか。既定値は true です。
payloadobjectYes--生成時に送る入力データです。ネストされた項目はモデルごとに異なります。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"
}
生成時に送る入力データです。ネストされた項目はモデルごとに異なります。 Dynamic payload fields by model を見る