视频生成

POST

https://api.tokencube.net/v2/llm/videos

将文本、图片作为输入，自动生成视频内容。当前支持文生视频、图生视频。

当前展示通用接口文档，各模型支持的参数存在差异。请在顶部切换模型，或直接点击下方模型标签，查看专属文档。

支持模型:

请求参数

请求头

参数名称	描述
Authorizationstring	鉴权令牌，格式为 Bearer ${AIGATEWAY_TOKEN}
Content-Typestring	可选值：multipart/form-dataapplication/json multipart/form-data 或 application/json

Body参数

参数名称	描述
modelstring	默认值：Per AI gateway configuration 可选值：sora-2sora-2-proMiniMax-Hailuo-2.3viduq2 模型名称
promptstring	文本描述，用于指导视频生成
secondsinteger	默认值：4 可选值：Model dependent 视频时长（秒）
sizestring	默认值：Model default 可选值：MiniMax-Hailuo-02 and MiniMax-Hailuo-2.3: 768P, 1080P; sora-2: 720x1280, 1280x720; sora-2-pro: 720x1280, 1280x720, 1792x1024, 1024x1792; viduq2/viduq2-pro: 540p, 720p, 1080p 视频分辨率，格式为"宽度x高度"或"720P/1080P"
input_referencearray	参考图片URL/Base64格式或文件（用于图生视频）。表单格式示例 -F "input_reference=@calico_cat_reference.png;type=image/png"；JSON请求示例 "input_reference": [{"eca_voice":"xx","image":["`http://example.com/example.jpeg`"]}]
eca_idstring	主体ID（Subject ID），可通过 @subjectId 在提示词中使用（部分模型支持，如vidu系列）
eca_voicestring	默认值：Model recommended 可选值：vidu voice list 主体语音标识，模型会自动推荐合适的语音（部分模型支持，如vidu系列）。vidu音色列表：https://shengshu.feishu.cn/sheets/EgFvs6DShhiEBStmjzccr5gonOg
imagearray	对应主体的图片URL列表。每个主体最多支持3张图片，可通过URL或Base64编码提供。必须使用以下编码格式之一：PNG、JPEG、JPG、WebP。图片尺寸至少为128x128像素，图片宽高比需小于1:4或4:1，单张图片大小限制为50MB，HTTP请求体大小不超过20MB且必须包含正确的Content-Type头信息。JSON示例 "image": ["http://example.com/example.jpeg","data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."]
eca_first_framestring	首帧图片URL/Base64格式或文件。表单格式示例 -F "eca_first_frame=@calico_first_reference.png;type=image/png"；JSON请求示例 "eca_first_frame": "http://example.com/example.jpeg"
eca_last_framestring	尾帧图片URL/Base64格式或文件。表单格式示例 -F "eca_last_frame=@calico_last_reference.png;type=image/png"；JSON请求示例 "eca_last_frame": "http://example.com/example.jpeg"
eca_audioboolean	默认值：false 可选值：truefalse 是否生成音频（部分模型支持，如vidu系列）。false：不需要音视频直出，输出静音视频；true：需要音视频直出，输出带台词以及背景音的视频
eca_voicestring	默认值：Model recommended 可选值：vidu voice list 用来决定视频中的声音音色，为空时模型会自动推荐（部分模型支持，如vidu系列），eca_audio=true生效。vidu音色列表：https://shengshu.feishu.cn/sheets/EgFvs6DShhiEBStmjzccr5gonOg
eca_aspect_ratiostring	默认值：Model default 可选值：viduq2: 16:9, 9:16, 4:3, 3:4, 1:1 视频宽高比（部分模型使用，如viduq2）

请求示例

curl -v 'https://${base_url}/v2/llm/videos' \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "seconds": 8,
    "size": "1280x720",
    "prompt": "A calico cat playing a piano on stage"
  }'

响应参数

Body参数

参数名称	描述
idstring	视频生成任务的唯一标识符
objectstring	可选值：video 对象类型，固定为 "video"
statusstring	任务状态，如 "queued"（排队中）

响应示例

{
  "id": "video_123",
  "object": "video",
  "status": "queued"
}

状态码

描述（message）	HTTP状态码
请求成功	200
访问被拒绝，拒绝原因见响应主体。可能的原因有：缺少Authorization请求头，token错误等。	401
访问被拒绝，拒绝原因见响应主体。可能的原因有：请求主体格式错误、请求主体缺少必要参数等。	403
服务器内部错误，原因见响应主体	500

请求参数

请求示例

响应参数

响应示例

状态码

目录