创建 Seedance 视频

通过统一的 POST /v1/videos 创建 Seedance 视频任务。模型能力以当前 Tikway 网关实际可调用范围为准。

模型	分辨率	时长	支持模式	音频	参考限制
seedance-2.5	480p / 720p / 1080p	4–30 秒；编辑/延长可用 -1 智能时长	文生、首帧、首尾帧、全模态参考、编辑、延长	支持	最多 50 个参考项
seedance-2.0	480p / 720p / 1080p / 4K	4–15 秒；编辑/延长可用 -1 智能时长	文生、首帧、首尾帧、全模态参考、编辑、延长	支持	最多 15 个参考项
seedance-2.0-mini	480p / 720p	4–15 秒	文生、首帧、首尾帧	支持	不支持全模态参考、编辑或延长

来源：火山方舟视频生成 API。官网能力与当前网关未开放能力之间的差异见本次审计报告。

POST https://api.tikway.ai/v1/videos

cURL

文生视频

curl --request POST \ --url https://api.tikway.ai/v1/videos \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "model": "seedance-2.5", "prompt": "一只金毛寻回犬在日落时分的海滩上奔跑，镜头平稳跟随，画面具有自然细腻的电影质感。", "duration": 8, "resolution": "1080p", "aspect_ratio": "16:9", "generate_audio": true } '

202

{
  "id": "9552de3d-171f-4cca-b492-7baa56523239",
  "status": "pending",
  "polling_url": "https://api.tikway.ai/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"
}

授权

Authorization · string · header · 必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

创建 Seedance 视频任务。参数按当前 Tikway 网关能力收窄；模型之间的差异见 operation 描述与 x-model-capabilities。

model · enum<string> · 必填

Seedance 模型 ID。

可用选项: seedance-2.5, seedance-2.0, seedance-2.0-mini

prompt · string

视频生成或编辑提示词。

Minimum string length: 1

duration · integer string

视频时长（秒）。2.0 Mini 为 4–15；2.0 为 4–15；2.5 为 4–30。编辑或延长任务可传 -1 让模型按输入素材决定时长。

必填范围: -1 <= x <= 30

aspect_ratio · enum<string>

视频宽高比。图生视频时，部分模型会按输入素材自动决定比例。

可用选项: adaptive, 16:9, 9:16, 1:1, 4:3, 3:4, 21:9

resolution · enum<string>

输出分辨率。不同模型或模式的可用值见模型能力表。

可用选项: 480p, 720p, 1080p, 4K

frame_images · object[]

首帧或尾帧参考图；同一类型最多一张。

Maximum array length: 2

Hide child attributes

frame_images. type · enum<string> · 必填

参考帧位置。

可用选项: first_frame, last_frame

frame_images. image_url · string<uri> · 必填

参考图 URL 字符串。

Minimum string length: 1

input_references · object[]

全模态参考素材。2.0 Mini 不支持；2.0 最多 15 项；2.5 最多 50 项。参考模式不能与首尾帧模式混用。

Maximum array length: 50

Option 1

Option 2

Option 3

Hide child attributes

input_references. image_url · string<uri> · 必填

图片 URL 字符串。

Minimum string length: 1

input_references. type · enum<string>

可选。素材类型；若提供，必须与对应 URL 字段一致。

可用选项: image_url, video_url, audio_url

input_references. role · enum<string>

素材用途。省略时按 URL 字段推断为普通参考素材。

可用选项: reference_image, reference_video, reference_audio, source_video, first_clip

input_references. video_url · string<uri>

视频 URL 字符串。

Minimum string length: 1

input_references. audio_url · string<uri>

音频 URL 字符串。

Minimum string length: 1

input_references. reference_voice · string

预设音色 ID；仅部分支持音色参考的模型使用。

Minimum string length: 1

generate_audio · boolean

支持生成音频；是否默认开启由模型与上游账号配置决定。

seed · integer

随机种子。固定种子只能提高可复现性，不保证输出完全一致。

必填范围: -1 <= x <= 2147483647

callback_url · string<uri>

用户任务回调地址。由 Tikway 在任务状态变化后调用，不直接传给模型上游。

Pattern: ^https://

extra_body · object

Seedance 上游扩展参数。

Hide child attributes

extra_body. camera_fixed · boolean

是否固定摄像头。

extra_body. watermark · boolean

是否添加水印。

extra_body. return_last_frame · boolean

是否在结果中返回最后一帧。

extra_body. omni_reference_task_type · enum<string>

全模态参考任务类型；编辑和延长由网关自动设置。

可用选项: auto, reference, edit, extend

extra_body. output_format · enum<string> · 默认值: mp4

可用选项: mp4, mov

extra_body. service_tier · enum<string>

可用选项: default, flex

extra_body. priority · integer

必填范围: 0 <= x <= 9

响应

202 - application/json

POST /v1/videos 创建视频任务成功后的响应参数，接口返回 HTTP 202。

id · string · 必填

视频生成任务的唯一标识，用于后续查询任务状态。

Minimum string length: 1

示例:

"9552de3d-171f-4cca-b492-7baa56523239"

status · enum<string> · 必填

任务创建状态。pending 表示任务已创建、等待提交处理；queue 表示任务已进入生成队列。

可用选项: pending, queue

示例:

"queue"

polling_url · string<uri> · 必填

视频任务查询地址，客户端可通过 GET 请求轮询任务状态。

Pattern: ^https://

示例:

"https://api.example.com/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"