AI Studio API

发起生成任务

使用模型 ID 和 payload 提交 AI Studio 生成请求。

API Playground

直接向当前站点发送真实请求，并立即查看 HTTP 响应。

POST

响应结果

发送请求后，响应内容会显示在这里。

POST/api/ai-studio/execute

发起一次新的生成任务。请求体包含 modelId、isPublic、payload。

请求头

Authorization: Bearer YOUR_API_KEYContent-Type: application/json

请求参数

参数名	类型	必填	默认值	可选值	说明
modelId	string	是	-	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	否	true	-	是否公开展示这次生成结果。默认 true。
payload	object	是	-	-	生成时提交的主要输入内容，不同模型的嵌套字段会不同。查看「Dynamic payload fields by model」

请求示例

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"
      }
    }
  }'

响应示例

{
  "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」