视频¶

Seedance 2.0¶

创建视频生成任务¶

提交视频生成任务，支持文生视频和图生视频。

curl -X POST "https://www.vastnum.com/v1/video/generations" \
  -H "Authorization: Bearer $WS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "全程使用视频1的第一视角构图，全程使用音频1作为背景音乐。第一人称视角果茶宣传广告，AVG牌「WSAI」苹果果茶限定款；首帧为图片1，你的手摘下一颗带晨露的阿克苏红苹果，轻脆的苹果碰撞声；2-4 秒：快速切镜，你的手将苹果块投入雪克杯，加入冰块与茶底，用力摇晃，冰块碰撞声与摇晃声卡点轻快鼓点，背景音：「鲜切现摇」；4-6 秒：第一人称成品特写，分层果茶倒入透明杯，你的手轻挤奶盖在顶部铺展，在杯身贴上粉红包标，镜头拉近看奶盖与果茶的分层纹理；6-8 秒：第一人称手持举杯，你将图片2中的果茶举到镜头前（模拟递到观众面前的视角），杯身标签清晰可见，背景音「来一口鲜爽」，尾帧定格为图片2。背景声音统一为女生音色。",
    "images": [
      "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg",
      "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg"
    ],
    "videos" :["https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4"],

    "audios": [
      "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
    ],
    "metadata": {
      "generate_audio": true,
      "resolution" : "480p",
      "ratio": "4:3",
      "duration": 5,
      "watermark": false
    }
  }'

返回任务 ID，可通过 GET 接口查询任务状态。

{"task_id":"任务ID"}

获取视频生成任务状态¶

查询视频生成任务的状态和结果。

curl https://www.vastnum.com/v1/video/generations/任务ID \
  -H "Authorization: Bearer $WS_API_KEY"

任务状态：

href="#__codelineno-3-1">{ "code": "success", "message": "", "data": { "task_id": "任务ID", "action": "generate", "status": "SUCCESS", "fail_reason": "", "submit_time": 1775188030, "start_time": 1775188043, "finish_time": 1775188329, "progress": "100%", "data": { "id": "任务ID", "draft": false, "model": "volcengine/doubao-seedance-2-0-260128", "ratio": "4:3", "frames": 0, "result": { "id": "cgt-20260403114650-qgcb2", "seed": 40141, "draft": false, "model": "doubao-seedance-2-0-260128", "ratio": "4:3", "usage": { "total_tokens": 99111, "completion_tokens": 99111 }, "status": "succeeded", "content": { "video_url": "视频下载地址" }, "duration": 5, "created_at": 1775188030, "resolution": "480p", "updated_at": 1775188324, "service_tier": "default", "generate_audio": true, "framespersecond": 24, "execution_expires_after": 172800 }, "status": "succeed", "duration": 5, "created_at": "2026-04-03T03:47:10Z", "resolution": "480p", "updated_at": "2026-04-03T03:52:04Z" } } }

queued: 排队中
in_progress: 生成中
completed: 已完成
failed: 失败

Kling¶

文生视频 - 创建任务¶

提交文生视频任务，返回任务 ID，可通过 GET 接口查询任务状态。

curl -X POST "https://www.vastnum.com/kling/v1/videos/text2video" \
  -H "Authorization: Bearer $WS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3",
    "prompt": "A cat playing piano in the garden",
    "negative_prompt": "blurry, low quality",
    "cfg_scale": 0.7,
    "mode": "pro",
    "aspect_ratio": "16:9",
    "duration": "4",
    "metadata": {
      "sound": "on"
    }
  }'

请求参数：

参数	类型	必填	说明
`model`	string	是	模型名称，如 `kling-v3`
`prompt`	string	是	正向提示词，描述期望生成的视频内容
`negative_prompt`	string	否	反向提示词，描述不希望出现的内容
`cfg_scale`	float	否	提示词遵循度，取值范围 `0`~`1`，值越大越贴合提示词
`mode`	string	否	生成模式，`std`（标准）或 `pro`（高质量）
`aspect_ratio`	string	否	画面比例，如 `16:9`、`9:16`、`1:1`
`duration`	string	否	视频时长（秒），如 `4`、`5`、`10`
`metadata.sound`	string	否	是否生成音频，`on` 开启，`off` 关闭

响应示例：

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "请求ID",
  "data": {
    "task_id": "任务ID",
    "task_status": "submitted",
    "created_at": 1775188030000,
    "updated_at": 1775188030000
  }
}

文生视频 - 查询任务¶

查询文生视频任务的状态和结果。

curl "https://www.vastnum.com/kling/v1/videos/text2video/任务ID" \
  -H "Authorization: Bearer $WS_API_KEY"

任务状态：

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "请求ID",
  "data": {
    "task_id": "任务ID",
    "task_status": "succeed",
    "task_status_msg": "",
    "created_at": 1775188030000,
    "updated_at": 1775188329000,
    "task_result": {
      "videos": [
        {
          "id": "视频ID",
          "url": "视频下载地址",
          "duration": "4"
        }
      ]
    }
  }
}

图生视频 - 创建任务¶

提交图生视频任务，使用图片作为视频首帧（可选尾帧），返回任务 ID。

curl -X POST "https://www.vastnum.com/kling/v1/videos/image2video" \
  -H "Authorization: Bearer $WS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3",
    "image": "https://example.com/first-frame.jpg",
    "image_tail": "https://example.com/last-frame.jpg",
    "prompt": "A cat playing piano in the garden",
    "negative_prompt": "blurry, low quality",
    "cfg_scale": 0.7,
    "mode": "pro",
    "duration": "4",
    "metadata": {
      "sound": "on"
    }
  }'

请求参数：

参数	类型	必填	说明
`model`	string	是	模型名称，如 `kling-v3`
`image`	string	是	首帧图片，支持图片 URL 或 Base64 编码
`image_tail`	string	否	尾帧图片，支持图片 URL 或 Base64 编码
`prompt`	string	否	正向提示词，描述期望生成的视频内容
`negative_prompt`	string	否	反向提示词，描述不希望出现的内容
`cfg_scale`	float	否	提示词遵循度，取值范围 `0`~`1`，值越大越贴合提示词
`mode`	string	否	生成模式，`std`（标准）或 `pro`（高质量）
`duration`	string	否	视频时长（秒），如 `4`、`5`、`10`
`metadata.sound`	string	否	是否生成音频，`on` 开启，`off` 关闭

响应示例：

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "请求ID",
  "data": {
    "task_id": "任务ID",
    "task_status": "submitted",
    "created_at": 1775188030000,
    "updated_at": 1775188030000
  }
}

图生视频 - 查询任务¶

查询图生视频任务的状态和结果。

curl "https://www.vastnum.com/kling/v1/videos/image2video/任务ID" \
  -H "Authorization: Bearer $WS_API_KEY"

任务状态：

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "请求ID",
  "data": {
    "task_id": "任务ID",
    "task_status": "succeed",
    "task_status_msg": "",
    "created_at": 1775188030000,
    "updated_at": 1775188329000,
    "task_result": {
      "videos": [
        {
          "id": "视频ID",
          "url": "视频下载地址",
          "duration": "4"
        }
      ]
    }
  }
}

Kling 任务状态：

submitted：已提交
processing：生成中
succeed：已完成
failed：失败