原站参考文档

以下为胜算云公开资料。文中的原站账号、地址、定价和专有服务不属于蓝天；蓝天可用模型以当前 sub2api 配置为准。接入蓝天请先查看快速开始。

Doubao-Seedance-2.5

bytedance/doubao-seedance-2-5 — Doubao Seedance 2.5（下文简称 Seedance 2.5）是新一代视频创作模型，在长叙事能力、全模态参考能力和编辑能力上全面提升。单次生成时长提升至 30 秒并支持多轮延长，单次参考多模态素材上限提升至 50 个，提供基于时间戳的精准编辑控制。画面质感全面优化，成片更接近实拍的影视质感。本文介绍 Seedance 2.5 模型的特色能力与使用方法，帮助您快速实现创建视频生成任务 API 调用。
异步任务：POST /v1/tasks/generations 提交 → GET /v1/tasks/generations/{request_id} 轮询结果（POST 发送后 request_id 自动填入 GET）。

BASE URLhttps://router.shengsuanyun.com/api

认证方式Authorization: Bearer YOUR_API_KEY

端点列表

← 上一页

豆包 Seedance 系列 · 接口汇总

Doubao-Seedance-2.0-fast

接口参考

以下为原文协议定义与示例，原站地址不代表蓝天已开通对应能力。蓝天接入地址和模型以本地配置为准。

蓝天 API 密钥

POST/v1/tasks/generationsSeedance2.5视频生成-异步

Doubao Seedance 2.5（下文简称 Seedance 2.5）是新一代视频创作模型，在长叙事能力、全模态参考能力和编辑能力上全面提升。单次生成时长提升至 30 秒并支持多轮延长，单次参考多模态素材上限提升至 50 个，提供基于时间戳的精准编辑控制。画面质感全面优化，成片更接近实拍的影视质感。本文介绍 Seedance 2.5 模型的特色能力与使用方法，帮助您快速实现创建视频生成任务 API 调用。。异步任务：POST 提交后返回 request_id，再用 GET /v1/tasks/generations/{request_id} 轮询结果。

请求体

application/json

字段类型说明

content必填

array

Seedance 2.5 单次参考多模态素材上限为 50 个。

展开结构

Seedance 2.5 单次参考多模态素材上限为 50 个。

array

数组元素

union

oneOf · 1

字段	类型	说明
`type`必填	string	内容类型，固定为 text。
`text`必填	string	文本提示词。

oneOf · 2

字段类型说明

type必填 string 内容类型，固定为 image_url。

image_url必填

object

展开结构

字段	类型	说明
`url`必填	string	图片 URL。

role

string

图片角色。首帧 first_frame，尾帧 last_frame，参考图 reference_image。

可选值："first_frame" · "last_frame" · "reference_image"

oneOf · 3

字段类型说明

type必填 string 内容类型，固定为 video_url。

video_url必填

object

展开结构

字段	类型	说明
`url`必填	string	视频 URL。

role string 视频角色，固定为 reference_video。

oneOf · 4

字段类型说明

type必填 string 内容类型，固定为 audio_url。

audio_url必填

object

展开结构

字段	类型	说明
`url`必填	string	音频 URL。

role string 音频角色，固定为 reference_audio。

callback_url stringuri 回调地址。

duration integer 视频时长，单位秒。可取 [4,30] 或 -1。视频编辑任务仅支持 -1（输出时长自动与输入视频一致）；其他任务 -1 表示模型智能选择。

execution_expires_after integer 任务超时阈值，单位秒。

generate_audio boolean 生成视频是否包含与画面同步的声音。

output_format

string

输出视频格式。

可选值："mp4" · "mov"

priority integer 执行优先级。

ratio

string

视频宽高比。

可选值："16:9" · "4:3" · "1:1" · "3:4" · "9:16" · "21:9" · "adaptive"

resolution

string

视频分辨率。

可选值："480p" · "720p"

return_last_frame boolean 是否返回尾帧图像。

safety_identifier string 终端用户唯一标识。

seed integer 随机种子。

tools

array

工具配置，支持 web_search。

展开结构

工具配置，支持 web_search。

array

数组元素

字段	类型	说明
`type`	string	可选值："web_search"

watermark boolean 生成视频是否包含水印。

omni_reference_task_type

string

全模态参考任务类型。auto=自动判断（默认），edit=视频编辑，extend=视频延长。显式指定 edit/extend 时接口会前置校验参数限制，不符合立即返回错误。

可选值："auto" · "edit" · "extend" · "reference"

model必填 string 路由模型，本页固定为 bytedance/doubao-seedance-2-5

anyOf · 1

文生视频异步任务：通过 content 数组组合 text / image_url / video_url 等，role 指定素材角色。触发条件：仅传入文本提示词 | 特殊限制：ratio / duration 无特殊限制

字段类型说明

content必填

array

Seedance 2.5 单次参考多模态素材上限为 50 个。

展开结构

Seedance 2.5 单次参考多模态素材上限为 50 个。

array

数组元素

union

oneOf · 1

字段	类型	说明
`type`必填	string	内容类型，固定为 text。
`text`必填	string	文本提示词。

oneOf · 2

字段类型说明

type必填 string 内容类型，固定为 image_url。

image_url必填

object

展开结构

字段	类型	说明
`url`必填	string	图片 URL。

role

string

图片角色。首帧 first_frame，尾帧 last_frame，参考图 reference_image。

可选值："first_frame" · "last_frame" · "reference_image"

oneOf · 3

字段类型说明

type必填 string 内容类型，固定为 video_url。

video_url必填

object

展开结构

字段	类型	说明
`url`必填	string	视频 URL。

role string 视频角色，固定为 reference_video。

oneOf · 4

字段类型说明

type必填 string 内容类型，固定为 audio_url。

audio_url必填

object

展开结构

字段	类型	说明
`url`必填	string	音频 URL。

role string 音频角色，固定为 reference_audio。

callback_url stringuri 回调地址。

duration integer 视频时长，单位秒。可取 [4,30] 或 -1。视频编辑任务仅支持 -1（输出时长自动与输入视频一致）；其他任务 -1 表示模型智能选择。

execution_expires_after integer 任务超时阈值，单位秒。

generate_audio boolean 生成视频是否包含与画面同步的声音。

output_format

string

输出视频格式。

可选值："mp4" · "mov"

priority integer 执行优先级。

ratio

string

视频宽高比。

可选值："16:9" · "4:3" · "1:1" · "3:4" · "9:16" · "21:9" · "adaptive"

resolution

string

视频分辨率。

可选值："480p" · "720p"

return_last_frame boolean 是否返回尾帧图像。

safety_identifier string 终端用户唯一标识。

seed integer 随机种子。

tools

array

工具配置，支持 web_search。

展开结构

工具配置，支持 web_search。

array

数组元素

字段	类型	说明
`type`	string	可选值："web_search"

watermark boolean 生成视频是否包含水印。

omni_reference_task_type

string

全模态参考任务类型。auto=自动判断（默认），edit=视频编辑，extend=视频延长。显式指定 edit/extend 时接口会前置校验参数限制，不符合立即返回错误。

可选值："auto" · "edit" · "extend" · "reference"

model必填 string 路由模型，本页固定为 bytedance/doubao-seedance-2-5

anyOf · 2

首帧图生视频异步任务：通过 content 数组组合 text / image_url / video_url 等，role 指定素材角色。触发条件：content.role 设置为 first_frame | 特殊限制：ratio 必须为 adaptive

字段类型说明

content必填

array

Seedance 2.5 单次参考多模态素材上限为 50 个。

展开结构

Seedance 2.5 单次参考多模态素材上限为 50 个。

array

数组元素

union

oneOf · 1

字段	类型	说明
`type`必填	string	内容类型，固定为 text。
`text`必填	string	文本提示词。

oneOf · 2

字段类型说明

type必填 string 内容类型，固定为 image_url。

image_url必填

object

展开结构

字段	类型	说明
`url`必填	string	图片 URL。

role

string

图片角色。首帧 first_frame，尾帧 last_frame，参考图 reference_image。

可选值："first_frame" · "last_frame" · "reference_image"

oneOf · 3

字段类型说明

type必填 string 内容类型，固定为 video_url。

video_url必填

object

展开结构

字段	类型	说明
`url`必填	string	视频 URL。

role string 视频角色，固定为 reference_video。

oneOf · 4

字段类型说明

type必填 string 内容类型，固定为 audio_url。

audio_url必填

object

展开结构

字段	类型	说明
`url`必填	string	音频 URL。

role string 音频角色，固定为 reference_audio。

callback_url stringuri 回调地址。

duration integer 视频时长，单位秒。可取 [4,30] 或 -1。视频编辑任务仅支持 -1（输出时长自动与输入视频一致）；其他任务 -1 表示模型智能选择。

execution_expires_after integer 任务超时阈值，单位秒。

generate_audio boolean 生成视频是否包含与画面同步的声音。

output_format

string

输出视频格式。

可选值："mp4" · "mov"

priority integer 执行优先级。

ratio

string

视频宽高比。当前模式下仅支持 adaptive。

可选值："adaptive"

resolution

string

视频分辨率。

可选值："480p" · "720p"

return_last_frame boolean 是否返回尾帧图像。

safety_identifier string 终端用户唯一标识。

seed integer 随机种子。

tools

array

工具配置，支持 web_search。

展开结构

工具配置，支持 web_search。

array

数组元素

字段	类型	说明
`type`	string	可选值："web_search"

watermark boolean 生成视频是否包含水印。

omni_reference_task_type

string

全模态参考任务类型。auto=自动判断（默认），edit=视频编辑，extend=视频延长。显式指定 edit/extend 时接口会前置校验参数限制，不符合立即返回错误。

可选值："auto" · "edit" · "extend" · "reference"

model必填 string 路由模型，本页固定为 bytedance/doubao-seedance-2-5

anyOf · 3

首尾帧图生视频异步任务：通过 content 数组组合 text / image_url / video_url 等，role 指定素材角色。触发条件：content.role 分别设置为 first_frame 和 last_frame | 特殊限制：ratio 必须为 adaptive

字段类型说明

content必填

array

Seedance 2.5 单次参考多模态素材上限为 50 个。

展开结构

Seedance 2.5 单次参考多模态素材上限为 50 个。

array

数组元素

union

oneOf · 1

字段	类型	说明
`type`必填	string	内容类型，固定为 text。
`text`必填	string	文本提示词。

oneOf · 2

字段类型说明

type必填 string 内容类型，固定为 image_url。

image_url必填

object

展开结构

字段	类型	说明
`url`必填	string	图片 URL。

role

string

图片角色。首帧 first_frame，尾帧 last_frame，参考图 reference_image。

可选值："first_frame" · "last_frame" · "reference_image"

oneOf · 3

字段类型说明

type必填 string 内容类型，固定为 video_url。

video_url必填

object

展开结构

字段	类型	说明
`url`必填	string	视频 URL。

role string 视频角色，固定为 reference_video。

oneOf · 4

字段类型说明

type必填 string 内容类型，固定为 audio_url。

audio_url必填

object

展开结构

字段	类型	说明
`url`必填	string	音频 URL。

role string 音频角色，固定为 reference_audio。

callback_url stringuri 回调地址。

duration integer 视频时长，单位秒。可取 [4,30] 或 -1。视频编辑任务仅支持 -1（输出时长自动与输入视频一致）；其他任务 -1 表示模型智能选择。

execution_expires_after integer 任务超时阈值，单位秒。

generate_audio boolean 生成视频是否包含与画面同步的声音。

output_format

string

输出视频格式。

可选值："mp4" · "mov"

priority integer 执行优先级。

ratio

string

视频宽高比。当前模式下仅支持 adaptive。

可选值："adaptive"

resolution

string

视频分辨率。

可选值："480p" · "720p"

return_last_frame boolean 是否返回尾帧图像。

safety_identifier string 终端用户唯一标识。

seed integer 随机种子。

tools

array

工具配置，支持 web_search。

展开结构

工具配置，支持 web_search。

array

数组元素

字段	类型	说明
`type`	string	可选值："web_search"

watermark boolean 生成视频是否包含水印。

omni_reference_task_type

string

全模态参考任务类型。auto=自动判断（默认），edit=视频编辑，extend=视频延长。显式指定 edit/extend 时接口会前置校验参数限制，不符合立即返回错误。

可选值："auto" · "edit" · "extend" · "reference"

model必填 string 路由模型，本页固定为 bytedance/doubao-seedance-2-5

anyOf · 4

参考图生视频异步任务：通过 content 数组组合 text / image_url / video_url 等，role 指定素材角色。触发条件：content 中至少包含一个 role 为 reference_image 的参考素材 | 特殊限制：ratio / duration 无特殊限制

字段类型说明

content必填

array

Seedance 2.5 单次参考多模态素材上限为 50 个。

展开结构

Seedance 2.5 单次参考多模态素材上限为 50 个。

array

数组元素

union

oneOf · 1

字段	类型	说明
`type`必填	string	内容类型，固定为 text。
`text`必填	string	文本提示词。

oneOf · 2

字段类型说明

type必填 string 内容类型，固定为 image_url。

image_url必填

object

展开结构

字段	类型	说明
`url`必填	string	图片 URL。

role

string

图片角色。首帧 first_frame，尾帧 last_frame，参考图 reference_image。

可选值："first_frame" · "last_frame" · "reference_image"

oneOf · 3

字段类型说明

type必填 string 内容类型，固定为 video_url。

video_url必填

object

展开结构

字段	类型	说明
`url`必填	string	视频 URL。

role string 视频角色，固定为 reference_video。

oneOf · 4

字段类型说明

type必填 string 内容类型，固定为 audio_url。

audio_url必填

object

展开结构

字段	类型	说明
`url`必填	string	音频 URL。

role string 音频角色，固定为 reference_audio。

callback_url stringuri 回调地址。

duration integer 视频时长，单位秒。可取 [4,30] 或 -1。视频编辑任务仅支持 -1（输出时长自动与输入视频一致）；其他任务 -1 表示模型智能选择。

execution_expires_after integer 任务超时阈值，单位秒。

generate_audio boolean 生成视频是否包含与画面同步的声音。

output_format

string

输出视频格式。

可选值："mp4" · "mov"

priority integer 执行优先级。

ratio

string

视频宽高比。

可选值："16:9" · "4:3" · "1:1" · "3:4" · "9:16" · "21:9" · "adaptive"

resolution

string

视频分辨率。

可选值："480p" · "720p"

return_last_frame boolean 是否返回尾帧图像。

safety_identifier string 终端用户唯一标识。

seed integer 随机种子。

tools

array

工具配置，支持 web_search。

展开结构

工具配置，支持 web_search。

array

数组元素

字段	类型	说明
`type`	string	可选值："web_search"

watermark boolean 生成视频是否包含水印。

omni_reference_task_type

string

全模态参考任务类型。auto=自动判断（默认），edit=视频编辑，extend=视频延长。显式指定 edit/extend 时接口会前置校验参数限制，不符合立即返回错误。

可选值："auto" · "edit" · "extend" · "reference"

model必填 string 路由模型，本页固定为 bytedance/doubao-seedance-2-5

anyOf · 5

参考视频生视频异步任务：通过 content 数组组合 text / image_url / video_url 等，role 指定素材角色。触发条件：content 中至少包含一个 role 为 reference_video 的参考素材 | 特殊限制：ratio / duration 无特殊限制

字段类型说明

content必填

array

Seedance 2.5 单次参考多模态素材上限为 50 个。

展开结构

Seedance 2.5 单次参考多模态素材上限为 50 个。

array

数组元素

union

oneOf · 1

字段	类型	说明
`type`必填	string	内容类型，固定为 text。
`text`必填	string	文本提示词。

oneOf · 2

字段类型说明

type必填 string 内容类型，固定为 image_url。

image_url必填

object

展开结构

字段	类型	说明
`url`必填	string	图片 URL。

role

string

图片角色。首帧 first_frame，尾帧 last_frame，参考图 reference_image。

可选值："first_frame" · "last_frame" · "reference_image"

oneOf · 3

字段类型说明

type必填 string 内容类型，固定为 video_url。

video_url必填

object

展开结构

字段	类型	说明
`url`必填	string	视频 URL。

role string 视频角色，固定为 reference_video。

oneOf · 4

字段类型说明

type必填 string 内容类型，固定为 audio_url。

audio_url必填

object

展开结构

字段	类型	说明
`url`必填	string	音频 URL。

role string 音频角色，固定为 reference_audio。

callback_url stringuri 回调地址。

duration integer 视频时长，单位秒。可取 [4,30] 或 -1。视频编辑任务仅支持 -1（输出时长自动与输入视频一致）；其他任务 -1 表示模型智能选择。

execution_expires_after integer 任务超时阈值，单位秒。

generate_audio boolean 生成视频是否包含与画面同步的声音。

output_format

string

输出视频格式。

可选值："mp4" · "mov"

priority integer 执行优先级。

ratio

string

视频宽高比。

可选值："16:9" · "4:3" · "1:1" · "3:4" · "9:16" · "21:9" · "adaptive"

resolution

string

视频分辨率。

可选值："480p" · "720p"

return_last_frame boolean 是否返回尾帧图像。

safety_identifier string 终端用户唯一标识。

seed integer 随机种子。

tools

array

工具配置，支持 web_search。

展开结构

工具配置，支持 web_search。

array

数组元素

字段	类型	说明
`type`	string	可选值："web_search"

watermark boolean 生成视频是否包含水印。

omni_reference_task_type

string

全模态参考任务类型。auto=自动判断（默认），edit=视频编辑，extend=视频延长。显式指定 edit/extend 时接口会前置校验参数限制，不符合立即返回错误。

可选值："auto" · "edit" · "extend" · "reference"

model必填 string 路由模型，本页固定为 bytedance/doubao-seedance-2-5

anyOf · 6

视频编辑任务：通过 content 数组组合 text / image_url / video_url 等，role 指定素材角色。触发条件：content 中至少包含一个 role 为 reference_video 的参考视频，并通过提示词表达编辑意图（如"删除""修改""替换"） | 特殊限制：ratio 必须为 adaptive；duration 必须为 -1；参考视频时长必须为 4-30 秒

字段类型说明

content必填

array

Seedance 2.5 单次参考多模态素材上限为 50 个。

展开结构

Seedance 2.5 单次参考多模态素材上限为 50 个。

array

数组元素

union

oneOf · 1

字段	类型	说明
`type`必填	string	内容类型，固定为 text。
`text`必填	string	文本提示词。

oneOf · 2

字段类型说明

type必填 string 内容类型，固定为 image_url。

image_url必填

object

展开结构

字段	类型	说明
`url`必填	string	图片 URL。

role

string

图片角色。首帧 first_frame，尾帧 last_frame，参考图 reference_image。

可选值："first_frame" · "last_frame" · "reference_image"

oneOf · 3

字段类型说明

type必填 string 内容类型，固定为 video_url。

video_url必填

object

展开结构

字段	类型	说明
`url`必填	string	视频 URL。

role string 视频角色，固定为 reference_video。

oneOf · 4

字段类型说明

type必填 string 内容类型，固定为 audio_url。

audio_url必填

object

展开结构

字段	类型	说明
`url`必填	string	音频 URL。

role string 音频角色，固定为 reference_audio。

callback_url stringuri 回调地址。

duration

integer

视频编辑模式下必须为 -1（输出时长自动与输入视频一致）。

展开结构

视频编辑模式下必须为 -1（输出时长自动与输入视频一致）。

integer

oneOf · 1

any

execution_expires_after integer 任务超时阈值，单位秒。

generate_audio boolean 生成视频是否包含与画面同步的声音。

output_format

string

输出视频格式。

可选值："mp4" · "mov"

priority integer 执行优先级。

ratio

string

视频宽高比。视频编辑模式下仅支持 adaptive。

可选值："adaptive"

resolution

string

视频分辨率。

可选值："480p" · "720p"

return_last_frame boolean 是否返回尾帧图像。

safety_identifier string 终端用户唯一标识。

seed integer 随机种子。

tools

array

工具配置，支持 web_search。

展开结构

工具配置，支持 web_search。

array

数组元素

字段	类型	说明
`type`	string	可选值："web_search"

watermark boolean 生成视频是否包含水印。

omni_reference_task_type

string

全模态参考任务类型。auto=自动判断（默认），edit=视频编辑，extend=视频延长。显式指定 edit/extend 时接口会前置校验参数限制，不符合立即返回错误。

可选值："auto" · "edit" · "extend" · "reference"

model必填 string 路由模型，本页固定为 bytedance/doubao-seedance-2-5

anyOf · 7

视频延长任务：通过 content 数组组合 text / image_url / video_url 等，role 指定素材角色。触发条件：content 中至少包含一个 role 为 reference_video 的参考视频，并通过提示词表达延长意图（如"延长""续写""延续"） | 特殊限制：ratio 必须为 adaptive；需传入参考视频

字段类型说明

content必填

array

Seedance 2.5 单次参考多模态素材上限为 50 个。

展开结构

Seedance 2.5 单次参考多模态素材上限为 50 个。

array

数组元素

union

oneOf · 1

字段	类型	说明
`type`必填	string	内容类型，固定为 text。
`text`必填	string	文本提示词。

oneOf · 2

字段类型说明

type必填 string 内容类型，固定为 image_url。

image_url必填

object

展开结构

字段	类型	说明
`url`必填	string	图片 URL。

role

string

图片角色。首帧 first_frame，尾帧 last_frame，参考图 reference_image。

可选值："first_frame" · "last_frame" · "reference_image"

oneOf · 3

字段类型说明

type必填 string 内容类型，固定为 video_url。

video_url必填

object

展开结构

字段	类型	说明
`url`必填	string	视频 URL。

role string 视频角色，固定为 reference_video。

oneOf · 4

字段类型说明

type必填 string 内容类型，固定为 audio_url。

audio_url必填

object

展开结构

字段	类型	说明
`url`必填	string	音频 URL。

role string 音频角色，固定为 reference_audio。

callback_url stringuri 回调地址。

duration integer 视频时长，单位秒。可取 [4,30] 或 -1。视频编辑任务仅支持 -1（输出时长自动与输入视频一致）；其他任务 -1 表示模型智能选择。

execution_expires_after integer 任务超时阈值，单位秒。

generate_audio boolean 生成视频是否包含与画面同步的声音。

output_format

string

输出视频格式。

可选值："mp4" · "mov"

priority integer 执行优先级。

ratio

string

视频宽高比。当前模式下仅支持 adaptive。

可选值："adaptive"

resolution

string

视频分辨率。

可选值："480p" · "720p"

return_last_frame boolean 是否返回尾帧图像。

safety_identifier string 终端用户唯一标识。

seed integer 随机种子。

tools

array

工具配置，支持 web_search。

展开结构

工具配置，支持 web_search。

array

数组元素

字段	类型	说明
`type`	string	可选值："web_search"

watermark boolean 生成视频是否包含水印。

omni_reference_task_type

string

全模态参考任务类型。auto=自动判断（默认），edit=视频编辑，extend=视频延长。显式指定 edit/extend 时接口会前置校验参数限制，不符合立即返回错误。

可选值："auto" · "edit" · "extend" · "reference"

model必填 string 路由模型，本页固定为 bytedance/doubao-seedance-2-5

{
  "model": "bytedance/doubao-seedance-2-5",
  "content": [
    {
      "type": "text",
      "text": "一段高级的电影感30秒视频，奇幻冒险风格"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/input.png"
      },
      "role": "reference_image"
    }
  ],
  "generate_audio": true,
  "ratio": "16:9",
  "duration": 30
}

请求示例

参考地址：https://router.shengsuanyun.com/api。路径参数与凭据需替换；非 JSON 请求体需按对应格式准备。

curl -X POST 'https://router.shengsuanyun.com/api/v1/tasks/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "bytedance/doubao-seedance-2-5",
  "content": [
    {
      "type": "text",
      "text": "一段高级的电影感30秒视频，奇幻冒险风格"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/input.png"
      },
      "role": "reference_image"
    }
  ],
  "generate_audio": true,
  "ratio": "16:9",
  "duration": 30
}'

响应

200 提交成功，返回 request_id / task_id

application/json

未提供结构定义。

{
  "code": "success",
  "message": "",
  "data": {
    "request_id": "REQ_xxx",
    "task_id": "TASK_xxx",
    "action": "GENERATION",
    "status": "PENDING",
    "progress": "0%"
  }
}

400 请求参数错误

401 未授权（API Key 无效）

429 请求过于频繁

500 服务器内部错误

GET/v1/tasks/generations/{request_id}查询异步任务状态与产物

通过 POST /v1/tasks/generations 返回的 request_id 轮询任务状态、进度与产物 URL（image_urls / video_urls / audio_urls / file_urls / text）。下方「在线测试」填入 request_id 即可发送查询；若上方 POST 已发送成功，request_id 会自动填入。

请求参数

参数	位置 / 类型	说明
`request_id`必填	path / string	POST /v1/tasks/generations 返回的请求 ID

请求示例

参考地址：https://router.shengsuanyun.com/api。路径参数与凭据需替换；非 JSON 请求体需按对应格式准备。

curl -X GET 'https://router.shengsuanyun.com/api/v1/tasks/generations/{request_id}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

响应

200 任务状态与产物

application/json

未提供结构定义。

{
  "code": "success",
  "message": "",
  "data": {
    "request_id": "REQ_xxx",
    "task_id": "TASK_xxx",
    "action": "video",
    "status": "PENDING",
    "progress": "0%"
  }
}

400 请求参数错误

401 未授权（API Key 无效）

429 请求过于频繁

500 服务器内部错误