视频生成接入指南
从选择 Seedance 或其他视频模型,到创建任务、查询状态和下载成片。
先选模型,再看支持哪些输入
用准备调用的 API Key 查看视频模型目录,按返回的模型 ID 和参数 Schema 确认文本、首帧或多模态参考是否可用。
Seedance 2.0 系列
从模型目录选可调用的规格。发参考图、视频或音频前,先核对该规格的 Schema、支持的素材角色和组合。
Seedance 2.5
使用首帧或首尾帧时,输出比例跟随首帧。在火山兼容路径上省略 ratio;其他路径以所选规格的 Schema 为准。
其他视频模型
例如你的目录中可调用的 Wan 或 MiniMax H3,使用平台统一接口,按相应 Schema 填写时长、分辨率和素材参数。
创建任务并取回视频
新接入或调用其他视频模型,先用平台统一接口。是否支持目标模型和输入,以当前 Key 的模型目录与 Schema 为准。
- 创建请求
POST https://intertoken.ai/v1/contents/generations/tasks- 查询原任务
GET https://intertoken.ai/v1/contents/generations/tasks/{id}- 成功时读取
output[].url
已有火山方舟 Seedance 代码时,可以使用火山兼容路径,换成 TokenPortal 的地址、API Key 和模型 ID。该路径仅适用于 Seedance。
- 创建请求
POST https://intertoken.ai/api/v3/contents/generations/tasks- 查询原任务
GET https://intertoken.ai/api/v3/contents/generations/tasks/{id}- 成功时读取
content.video_url
保存创建返回的任务 ID,并用同一个 Key 在原路径查询。创建结果不明时,先按同一路径的重试说明核对;不要为了查询结果再创建一遍。
选择一种输入
按所选接口和模型填充请求。用模型目录里的 ID 替换 MODEL_ID,素材地址换成自己的地址。
用提示词描述画面。生成参数按所选模型的 Schema 填写。
{
"model": "MODEL_ID",
"content": [
{
"type": "text",
"text": "A slow camera pan over a city at dusk."
}
]
}用一张图确定开场画面,图片角色填 first_frame。
{
"model": "MODEL_ID",
"content": [
{
"type": "text",
"text": "A slow camera push from this first frame."
},
{
"type": "image_url",
"role": "first_frame",
"image_url": {
"url": "https://example.com/first-frame.jpg"
}
}
]
}用一张图片生成视频(首帧模式)按模型 Schema 核对参考类型与组合。多模态参考与首帧、首尾帧是不同场景,一次请求不要混用。
{
"model": "MODEL_ID",
"content": [
{
"type": "text",
"text": "Use the image as the visual reference."
},
{
"type": "image_url",
"role": "reference_image",
"image_url": {
"url": "https://example.com/reference.jpg"
}
}
]
}端点参考 · 素材库首帧与参考素材
按所选模型的 Schema 准备输入。支持公网 URL 时可以直接传;如需素材引用,请按素材库说明登记,等待素材可用后使用登记结果返回的 ref。