AI Studio API

生成タスクを作成

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

API Playground

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

POST

レスポンス

リクエストを送信すると、ここにレスポンスが表示されます。

POST/api/ai-studio/execute

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

Request Headers

Authorization: Bearer YOUR_API_KEYContent-Type: application/json

Request Parameters

Name	Type	Required	Default	Options	Description
modelId	string	Yes	-	video:wan-text-to-video, video:grok-imagine-text-to-video, video:grok-imagine-image-to-video, video:wan-image-to-video, video:kling-2-6-text-to-video, video:kling-2-6-image-to-video, video:wan-2-7-text-to-video, video:wan-2-7-image-to-video, video:kling-3-0, video:kling-2-6-motion-control, video:wan-2-7-reference-to-video, video:wan-2-7-video-edit, video:kling-3-0-motion-control, image:z-image, image:grok-imagine-image-to-image, image:wan-2-7-image, image:grok-imagine-text-to-image, image:seedream5-0-lite-text-to-image, image:seedream5-0-lite-image-to-image, image:qwen2-text-to-image, image:qwen2-image-edit, image:seedream4-5-text-to-image, image:seedream4-5-edit, image:wan-2-7-image-pro	選択した動画モデルの ID です。
isPublic	boolean	No	true	-	生成結果を公開するかどうか。既定値は true です。
payload	object	Yes	-	-	生成時に送る入力データです。ネストされた項目はモデルごとに異なります。Dynamic payload fields by model を見る

Request

curl -X POST "https://spicyai.site/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 を見る