SD2 接口调用文档

本文档说明如何通过网关提交 SD2 视频生成任务，以及如何查询任务结果。

1. 通用说明

接口基础地址：

https://open-gateway.anspire.cn

如果部署环境配置了统一前缀，路径需要带前缀，例如：

https://open-gateway.anspire.cn/v6/submitTask
https://open-gateway.anspire.cn/v6/queryTasKResult

通用请求头：

Header	必传	示例	说明
`Content-Type`	是	`application/json`	请求体格式
`Authorization`	是	`Bearer ${GATEWAY_AUTH_KEY}`	网关访问密钥

2. 提交文生视频任务

请求方式：

POST /submitTask

请求示例：

curl -X POST "https://open-gateway.anspire.cn/v6/submitTask" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${GATEWAY_AUTH_KEY}" \
  -d '{
    "params": {
      "prompt": "一只小猫在阳光下奔跑，电影感镜头",
      "model": "cinema-generate-2.0",
      "duration": "5",
      "mode": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true,
      "tools": false
    }
  }'

3. 提交参考生视频任务

参考生视频需要在 multi_model_url 中传入至少一个 media_type 为 video 的参考视频。

请求方式：

POST /submitTask

请求示例：

curl -X POST "https://open-gateway.anspire.cn/v6/submitTask" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${GATEWAY_AUTH_KEY}" \
  -d '{
    "params": {
      "multi_model_url": [
        {
          "ref_name": "参考视频1",
          "url": "https://example.com/reference.mp4",
          "media_type": "video"
        }
      ],
      "prompt": "参考视频中的人物动作，生成同风格街景视频",
      "model": "cinema-generate-2.0",
      "duration": "5",
      "mode": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true,
      "tools": false
    }
  }'

4. submitTask 参数说明

请求体结构：

{
  "params": {
    "prompt": "提示词",
    "model": "cinema-generate-2.0",
    "duration": "5",
    "mode": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true,
    "tools": false,
    "multi_model_url": []
  }
}

params 参数：

参数	类型	必传	说明
`prompt`	string	是	生成视频的提示词，最大 `2500` 字符
`model`	string	是	模型名称，例如 `cinema-generate-2.0`
`duration`	string/int	是	视频时长。文生视频支持 `4` 到 `12`；参考生视频支持 `4` 到 `15`
`mode`	string	是	清晰度。文生视频支持 `480p`、`720p`；参考生视频支持 `480p`、`720p`、`1080p`
`aspect_ratio`	string	是	宽高比，可选 `16:9`、`9:16`、`4:3`、`1:1`、`3:4`、`21:9`
`generate_audio`	boolean	是	是否生成音频
`tools`	boolean	否	是否开启联网搜索，默认 `false`
`multi_model_url`	object[]	否	参考素材列表；参考生视频时需要传入

multi_model_url 参数：

参数	类型	必传	说明
`ref_name`	string	是	参考素材名称
`url`	string	是	公网可访问的素材 URL
`media_type`	string	是	素材类型：`image`、`video`、`audio`

参考素材限制：

类型	限制
图片	最多 9 张，最大 30MB，支持 `jpg/jpeg/png/webp`
视频	最多 3 个，最大 50MB，支持 `mp4/mov`，单个时长 `2s` 到 `14s`
音频	最多 3 个，最大 15MB，支持 `mp3/wav`，单个时长 `2s` 到 `14s`

说明：

不传 multi_model_url 时，按文生视频提交。
multi_model_url 中包含至少一个 media_type=video 时，按参考生视频提交。
参考视频 URL 必须公网可访问。

5. submitTask 响应

提交成功后，响应中会返回任务 ID genTaskId。

响应示例：

{
  "requestId": "s-86e4c7ed0eff4fbf967b81f-0c47d1",
  "result": {
    "result": {
      "appId": "app_id",
      "genTaskId": "10413696",
      "requestId": "request_id",
      "success": true
    }
  }
}

调用方需要保存 genTaskId，用于后续查询任务结果。

6. 查询任务结果

请求方式：

POST /queryTasKResult

请求示例：

curl -X POST "https://open-gateway.anspire.cn/v6/queryTasKResult" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${GATEWAY_AUTH_KEY}" \
  -d '{
    "genTaskId": "10413696"
  }'

请求参数：

参数	类型	必传	说明
`genTaskId`	string	是	`submitTask` 返回的任务 ID

查询成功后会返回任务状态和结果。常见状态含义：

状态	说明
`queued` / `pending` / `running` / `processing`	任务处理中
`success` / `succeeded` / `completed` / `done` / `4`	任务成功
`failed` / `fail` / `error` / `cancelled` / `canceled` / `2`	任务失败

7. 常见错误

场景	处理建议
鉴权失败	检查 `Authorization` 是否存在，格式是否为 `Bearer ${GATEWAY_AUTH_KEY}`
参数错误	检查 `params` 是否存在，`duration`、`mode`、`multi_model_url` 是否符合要求
参考视频不可用	检查视频 URL 是否公网可访问，视频格式和时长是否符合要求
模型不可用	检查 `model` 是否正确，当前访问密钥是否有权限调用该模型
任务无法查询	检查 `genTaskId` 是否正确，是否由当前访问密钥提交

8. 计费说明

SD2 按生成视频时长计费，单价由生成类型、参考视频时长和分辨率共同决定。

计费公式：

费用 = 生成时长(秒) × 单价(元/秒)

文生视频 / 图生视频 / 首尾帧 / 无参考视频

分辨率	单价	折扣
480p	0.462 元/秒	-
720p	0.994 元/秒	-

参考视频生视频

参考视频时长不同，单价不同。参考视频越长，单价越高。

参考视频时长	480p 单价	720p 单价	折扣
2-4s	0.506 元/秒	1.088 元/秒	-
5s	0.562 元/秒	1.209 元/秒	-
6s	0.618 元/秒	1.33 元/秒	-
7s	0.675 元/秒	1.451 元/秒	-
8s	0.731 元/秒	1.572 元/秒	-
9s	0.787 元/秒	1.693 元/秒	-
10s	0.843 元/秒	1.815 元/秒	-
11s	0.899 元/秒	1.936 元/秒	-
12s	0.955 元/秒	2.057 元/秒	-
13s	1.012 元/秒	2.178 元/秒	-
14s	1.068 元/秒	2.299 元/秒	-
15s	1.124 元/秒	2.42 元/秒	-

计费示例

文生视频，生成 5 秒 720p 视频：5 × 0.994 = 4.97 元
参考生视频（参考视频 8s），生成 10 秒 480p 视频：10 × 0.731 = 7.31 元
参考生视频（参考视频 12s），生成 6 秒 720p 视频：6 × 2.057 = 12.34 元

1. 通用说明​

2. 提交文生视频任务​

3. 提交参考生视频任务​

4. submitTask 参数说明​

5. submitTask 响应​

6. 查询任务结果​

7. 常见错误​

8. 计费说明​

文生视频 / 图生视频 / 首尾帧 / 无参考视频​

参考视频生视频​

计费示例​

1. 通用说明

2. 提交文生视频任务

3. 提交参考生视频任务

4. submitTask 参数说明

5. submitTask 响应

6. 查询任务结果

7. 常见错误

8. 计费说明

文生视频 / 图生视频 / 首尾帧 / 无参考视频

参考视频生视频

计费示例