创建视频任务

创建一个视频生成 task。视频生成和图片生成一样使用 API Key 鉴权。

POST /api/video-generations

请求参数

字段	类型	必填	默认值	说明
`prompt`	`string`	是	无	视频提示词，trim 后 1-12000 字符
`modelId`	`string`	否	`seedance-2-a`	见下方模型表
`generationType`	`string`	否	`text-to-video`	`text-to-video`、`image-to-video`、`video-to-video`、`multimodal-to-video`
`videoMode`	`string`	否	按 `generationType` 和参考资产自动推断	`text`、`startEndFrame`、`multiImageRef`、`videoRef`、`omniRef`
`aspectRatio`	`string`	否	`16:9`	`1:1`、`16:9`、`9:16`、`4:3`、`3:4`、`3:2`、`2:3`、`21:9`、`adaptive`；不同模型会进一步校验
`resolution`	`string`	否	`720p`	`480p`、`720p`、`1080p`、`4k`；不同模型支持范围不同
`durationSeconds`	`number`	否	Veo 固定 `8`；Grok 默认 `6`；其他默认 `5`	整数秒；不同模型有不同范围
`videoCount`	`number`	否	`1`	生成数量，1-8
`audio`	`boolean`	否	Veo 固定 `true`；Grok 固定 `false`；Kling Omni 有视频参考时默认 `false`；其他支持声音的模型默认 `true`	是否生成声音
`references`	`object`	否	空引用	参考素材资产 ID
`providerOptions`	`object`	否	`{}`	目前用于 Kling 的高级参数
`idempotencyKey`	`string`	否	自动生成随机 key	建议传入，trim 后最多 128 字符，用于防止重复提交

未知字段会被拒绝。所有字符串字段都会先 trim，再进入业务逻辑。

references

参考图片、视频、音频需要先通过上传参考图片中的一步上传接口创建资产。该上传接口同样支持视频和音频 MIME 类型。

字段	类型	默认值	说明
`firstFrameAssetId`	`string \| null`	`null`	首帧参考图资产 ID
`lastFrameAssetId`	`string \| null`	`null`	尾帧参考图资产 ID
`imageAssetIds`	`string[]`	`[]`	普通参考图资产 ID
`videoAssetIds`	`string[]`	`[]`	参考视频资产 ID
`audioAssetIds`	`string[]`	`[]`	参考音频资产 ID

服务端会校验 MIME 类型：图片引用必须是 image/*，视频引用必须是 video/*，音频引用必须是 audio/*。

providerOptions.kling

字段	类型	默认值	说明
`negativePrompt`	`string`	无	Kling 负向提示词，最多 2500 字符
`multiShot`	`boolean`	无	是否启用多镜头
`shotType`	`string`	无	`intelligence` 为智能分镜；`customize` 需要同时传 `multiPrompt`
`multiPrompt`	`object[]`	无	自定义分镜，最多 6 段；每段包含 `index`、`prompt`、`duration`，总时长必须等于 `durationSeconds`
`elements`	`object[]`	无	Kling 主体参考，最多 3 个主体；每个主体需要 2-4 张图
`videoReference.referType`	`string`	无	仅 `kling-v3-omni` + 视频参考可用；`base` 或 `feature`
`videoReference.keepOriginalSound`	`boolean`	无	仅 `kling-v3-omni` + 视频参考可用

kling-v3 只支持文生视频和首尾帧图生视频。kling-v3-omni 支持更多参考模式，但视频参考不能和生成声音同时使用，也不支持 4K 视频参考。

模型限制

模型	支持模式	分辨率	比例	时长	参考限制
`seedance-2-a`	全部模式	`480p`、`720p`、`1080p`	全部视频比例	4-15s	首尾帧最多 2 张；普通参考图最多 4 张；视频最多 3 个；音频最多 3 个
`seedance-2-b-fast`	全部模式	`480p`、`720p`	全部视频比例	4-15s	同 Seedance A
`seedance-2-c-face`	全部模式	`480p`、`720p`、`1080p`	全部视频比例	4-15s	同 Seedance A
`seedance-2-d-fast-face`	全部模式	`480p`、`720p`	全部视频比例	4-15s	同 Seedance A
`veo-3.1-a-fast`	`text`、`startEndFrame`、`multiImageRef`	`720p`、`1080p`、`4k`	`16:9`、`9:16`	固定 8s	不支持视频/音频参考；普通参考图最多 3 张
`veo-3.1-b-quality`	`text`、`startEndFrame`	`720p`、`1080p`、`4k`	`16:9`、`9:16`	固定 8s	不支持视频/音频参考；仅首尾帧
`veo-3.1-c-lite`	`text`	`720p`、`1080p`、`4k`	`16:9`、`9:16`	固定 8s	不支持参考素材
`kling-v3`	`text`、`startEndFrame`	`720p`、`1080p`、`4k`	`16:9`、`9:16`、`1:1`	3-15s	不支持视频/音频参考
`kling-v3-omni`	全部模式	`720p`、`1080p`、`4k`	`16:9`、`9:16`、`1:1`	3-15s	视频参考最多 1 个；视频参考不支持 4K
`grok-imagine-1.5-video`	`text`、`multiImageRef`	`480p`、`720p`	`16:9`、`9:16`、`1:1`、`3:2`、`2:3`	6-30s	只支持普通参考图，最多 7 张；不可生成声音

计费

视频价格按下表固定计费。Veo 固定按 8 秒计费。Seedance 如果有视频参考，会按 输出时长 + 参考视频总时长 计费；参考视频时长来自已注册资产的 metadata.durationSeconds。

模型	价格规则
`seedance-2-a`	480p：86 credits/s，无视频参考；53 credits/s，有视频参考。720p：186 / 112 credits/s。1080p：418 / 254 credits/s
`seedance-2-b-fast`	480p：70 / 42 credits/s。720p：149 / 90 credits/s
`seedance-2-c-face`	480p：118 / 72 credits/s。720p：254 / 153 credits/s。1080p：593 / 356 credits/s
`seedance-2-d-fast-face`	480p：95 / 57 credits/s。720p：204 / 123 credits/s
`veo-3.1-a-fast`	720p/1080p：214 credits/个；4k：285 credits/个
`veo-3.1-b-quality`	720p/1080p：712 credits/个；4k：2277 credits/个
`veo-3.1-c-lite`	720p/1080p：178 credits/个；4k：237 credits/个
`kling-v3`	720p：80 credits/s，无声；120 credits/s，有声。1080p：107 / 160 credits/s。4k：509 credits/s
`kling-v3-omni`	无视频参考：720p 80 / 107 credits/s；1080p 107 / 133 credits/s；4k 509 credits/s。视频参考：720p 120 credits/s；1080p 160 credits/s
`grok-imagine-1.5-video`	9 credits/s；默认无声，不可选择声音

总扣费为 videoCount * 单个视频价格。创建 task 时会预扣积分；如果子 job 最终失败，会按失败 job 退回积分。

文生视频示例

curl -X POST "$CUTAI_BASE_URL/api/video-generations" \
  -H "Authorization: Bearer $CUTAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cinematic product reveal, soft studio light, slow camera push in",
    "modelId": "seedance-2-a",
    "generationType": "text-to-video",
    "aspectRatio": "16:9",
    "resolution": "720p",
    "durationSeconds": 5,
    "videoCount": 1,
    "idempotencyKey": "video_order_10001"
  }'

图生视频示例

curl -X POST "$CUTAI_BASE_URL/api/video-generations" \
  -H "Authorization: Bearer $CUTAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Animate the product with a subtle turntable motion",
    "modelId": "kling-v3",
    "generationType": "image-to-video",
    "videoMode": "startEndFrame",
    "aspectRatio": "16:9",
    "resolution": "720p",
    "durationSeconds": 5,
    "references": {
      "firstFrameAssetId": "ast_first_frame",
      "lastFrameAssetId": "ast_last_frame"
    }
  }'

响应

{
  "batch": {
    "request": {
      "modelId": "seedance-2-a",
      "generationType": "text-to-video",
      "aspectRatio": "16:9",
      "resolution": "720p",
      "durationSeconds": 5,
      "videoCount": 1
    },
    "results": [
      {
        "job": {
          "id": "job_xxx",
          "status": "queued"
        },
        "assets": []
      }
    ],
    "totalCreditCost": 926,
    "balanceAfterCredits": 9074
  },
  "billing": {
    "totalCreditCost": 926,
    "balanceAfterCredits": 9074
  }
}

HTTP 状态码为 202 表示任务已入队或已被接受。后续使用查询任务状态轮询 batch.task.id 或响应中的 task ID。

​请求参数

​references

​providerOptions.kling

​模型限制

​计费

​文生视频示例

​图生视频示例

​响应