Shuchuang 高清直出视频生成接口

Shuchuang 高清直出系列视频生成接口，支持 1080P 与 4K 两档分辨率，按 token 计费。提供标准版、快速版、精简版（shuchuang-2.0 / shuchuang-2.0-fast / shuchuang-2.0-mini）及增强版（shuchuang-2.5）共 4 个模型。

支持的模型

模型名称	说明	支持分辨率
shuchuang-2.0	标准版，画质优，生成较慢	1080p、4K
shuchuang-2.0-fast	快速版，速度更快，画质略低	1080p、4K
shuchuang-2.0-mini	精简版，成本更低、速度更快，适合大批量生成	1080p、4K
shuchuang-2.5	增强版，视频时长上限延长，素材上限提升，原生多语言支持	1080p、4K

分辨率说明：所有模型均支持 1080p（默认）与 4K 两档分辨率。选择 4K 时计费单价更高，详见下方 resolution 参数说明。

接口统一说明：以上模型使用相同的请求参数（metadata.content[] + metadata.ratio + metadata.duration），仅需切换 model 字段即可切换模型；各模型在分辨率、时长上限、素材数量、计费单价等方面存在差异。

接口地址

提交任务

POST {BASE_URL}/v1/video/generations

查询结果

GET {BASE_URL}/v1/video/generations/{task_id}

请求参数

顶级参数

参数	类型	必填	说明
model	string	是	模型名称：`shuchuang-2.0`、`shuchuang-2.0-fast`、`shuchuang-2.0-mini` 或 `shuchuang-2.5`
prompt	string	是	文本提示词（平台校验要求非空，实际提示词通过 metadata.content 传递）
metadata	object	是	扩展参数对象，包含所有 Shuchuang 参数

metadata 参数

参数	类型	必填	说明	默认值
content	object[]	是	输入给模型的内容数组，详见下方 content 参数说明	-
generate_audio	boolean	否	控制生成的视频是否包含与画面同步的声音	`true`
resolution	string	否	视频分辨率，取值 `"1080p"` 或 `"4k"`，详见下方 resolution 参数说明	`"1080p"`
ratio	string	否	视频宽高比，详见下方 ratio 参数说明	`"16:9"`
duration	integer	否	视频时长（秒），取值范围随模型而不同	`5`
tools	object[]	否	配置模型要调用的工具（如联网搜索），详见下方 tools 参数说明	-
output_format	string	否	输出视频格式，`mp4` 或 `mov`，仅 `shuchuang-2.5` 支持	`"mp4"`
omni_reference_task_type	string	否	全模态参考生视频任务类型引导，`auto` / `reference` / `edit` / `extend`，仅 `shuchuang-2.5` 支持	`"auto"`

注意：prompt 字段必须非空（平台校验要求），但实际发送给模型的提示词来自 metadata.content 中的文本内容。如果未传 metadata.content，平台会自动将 prompt 转换为 content 数组。

content 参数详细说明

metadata.content 为对象数组，输入给模型生成视频的信息，支持文本、图片、音频、视频。支持以下几种组合：

文本

文本（可选）+ 图片

文本（可选）+ 视频

文本（可选）+ 图片 + 音频

文本（可选）+ 图片 + 视频

文本（可选）+ 视频 + 音频

文本（可选）+ 图片 + 视频 + 音频

文本信息

输入给模型的提示词信息。

字段	类型	必填	说明
type	string	是	固定为 `"text"`
text	string	是	文本提示词，描述期望生成的视频。支持中英文。建议中文不超过 500 字，英文不超过 1000 词。字数过多信息容易分散，模型可能忽略细节，造成视频缺失部分元素。

示例：

{
  "type": "text",
  "text": "清晨的海边，金色阳光照耀在海面上，一只海豚跃出水面，水花四溅"
}

图片信息

输入给模型的图片信息。

字段	类型	必填	说明
type	string	是	固定为 `"image_url"`
image_url	object	是	图片对象
image_url.url	string	是	图片 URL、Base64 编码或素材 ID（见下方说明）
role	string	条件必填	图片的位置或用途（见下方说明）

image_url.url 支持的格式：

图片 URL：填入图片的公网 URL

Base64 编码：格式 data:image/<图片格式>;base64,<Base64编码>，如 data:image/png;base64,{base64_image}

素材 ID：格式 asset://{id}，需先通过素材库 API 上传素材并获得素材 ID

role 字段取值：

role	说明
reference_image	参考图片（默认值）：模型参考画面风格与构图，生成与之相似的视频
first_frame	首帧图：将该图作为视频的首帧，生成从该画面开始的视频
last_frame	尾帧图：将该图作为视频的尾帧，生成以该画面结束的视频

首尾帧模式说明：若 content 中同时包含 first_frame 和 last_frame 两张图，模型会生成从首帧图过渡到尾帧图的视频，实现精确的起止画面控制。

示例：

{
  "type": "image_url",
  "image_url": {
    "url": "asset://asset-20260628110321-abcde"
  },
  "role": "first_frame"
}

视频信息

输入给模型的参考视频信息。

字段	类型	必填	说明
type	string	是	固定为 `"video_url"`
video_url	object	是	视频对象
video_url.url	string	是	视频 URL 或素材 ID（格式同图片）
role	string	否	固定为 `"reference_video"`（参考视频）

示例：

{
  "type": "video_url",
  "video_url": {
    "url": "asset://asset-20260628110423-xyz12"
  },
  "role": "reference_video"
}

音频信息

输入给模型的参考音频信息。

字段	类型	必填	说明
type	string	是	固定为 `"audio_url"`
audio_url	object	是	音频对象
audio_url.url	string	是	音频 URL 或素材 ID（格式同图片）
role	string	否	固定为 `"reference_audio"`（参考音频）

示例：

{
  "type": "audio_url",
  "audio_url": {
    "url": "asset://asset-20260628110530-audio1"
  },
  "role": "reference_audio"
}

resolution 参数说明 {#resolution}

控制视频分辨率，取值 "1080p"（默认）或 "4k"。

值	说明	计费影响
`1080p`	1920×1080（默认）	基准单价
`4k`	3840×2160	单价约为 1080p 的 1.6 倍

选择更高分辨率时单价更高；同一请求若含参考视频，单价会进一步降低。具体单价以模型价格配置为准。

ratio 参数说明 {#ratio}

控制视频宽高比。

值	说明
`16:9`	横屏（默认）
`9:16`	竖屏
`1:1`	方形
`4:3`	横屏 4:3
`3:4`	竖屏 3:4
`21:9`	超宽屏

编码约束：当 ratio 数值 ≥ 2.34 时，系统可能自动切换视频编码以满足限制。若超出所有编码上限，创建任务会失败并返回 sr_ratio_exceeded 错误。

完整请求示例

纯文本生成

图生视频（首帧图）

4K 高清生成

响应格式

提交任务成功

{
  "task_id": "task_3WG1JjQsqG4BVEEwFLZuIU2slLVZhGhf"
}

保存 task_id 用于后续查询。

查询任务结果

成功响应

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_3WG1JjQsqG4BVEEwFLZuIU2slLVZhGhf",
    "action": "generate",
    "status": "SUCCESS",
    "result_url": "https://example.com/uploads/20260901/output.mp4",
    "progress": "100%"
  }
}

字段	说明
status	任务状态：`QUEUED` / `IN_PROGRESS` / `SUCCESS` / `FAILED`
result_url	生成视频的下载链接（成功后有值）
progress	进度百分比

处理中 / 失败

处理中：status 为 QUEUED 或 IN_PROGRESS，请每隔约 15 秒轮询一次。

失败：status 为 FAILED，data.fail_reason 说明失败原因。

计费说明

按 token 用量计费，单位：元 / 100 万 tokens。

计费公式

费用（元）= total_tokens × 单价（元/100万tokens）/ 1,000,000

影响单价的因素

分辨率：1080p（基准）vs 4k（约 1.6 倍）

是否含参考视频：含参考视频时单价更低（约为无参考视频的 60%）

模型版本：-mini 成本最低，标准版居中，-2.5 略高

具体单价以「模型价格配置」为准。任务完成后按实际 token 用量结算，多退少补。

常见问题

1. 如何使用素材库中的图片/视频？

先通过素材库 API 上传素材，获得 asset://asset-xxxxxx 引用地址，填入 content 数组的 image_url.url 或 video_url.url。

2. 为什么提示「模型无权限」？

创建 API 令牌时需选择对应的模型分组。若已有令牌未选该分组，请联系管理员调整令牌权限。

3. 如何控制生成视频的起止画面？

用 first_frame 和 last_frame 两个 role 上传首尾帧图片，模型会生成从首帧过渡到尾帧的视频。

Shuchuang 高清直出视频生成接口

支持的模型#

接口地址#

提交任务#

查询结果#

请求参数#

顶级参数#

metadata 参数#

content 参数详细说明#

文本信息#

图片信息#

视频信息#

音频信息#

resolution 参数说明 {#resolution}#

ratio 参数说明 {#ratio}#

完整请求示例#

纯文本生成#

图生视频（首帧图）#

4K 高清生成#

响应格式#

提交任务成功#

查询任务结果#

成功响应#

处理中 / 失败#

计费说明#

计费公式#

影响单价的因素#

常见问题#

1. 如何使用素材库中的图片/视频？#

2. 为什么提示「模型无权限」？#

3. 如何控制生成视频的起止画面？#

相关文档#