4SToken
API Reference

接口参考

按接口拆分查看请求地址、输入参数、输出参数与错误代码。

编程工具接入模型与价格
Gateway Protocols多标准协议兼容
OpenAIAnthropicGeminiOpenRouter
Chat / Responses / Messages / Claude Messages
POST /v1/videos

视频生成

Gateway JSON 视频生成主入口；请求字段和响应采用 Gateway 契约，同时支持火山 Seedance content[] 写法。

上一页下一页

接口信息

请求地址https://api.4stoken.cn
请求路径/v1/videos
请求方式POST
协议标准Gateway Video API
能力分类视频生成
Content-Typeapplication/json
鉴权Authorization: Bearer sk-...

输入参数

接口清单

参数类型必填说明
POST /v1/videosapplication/json推荐新接入Gateway JSON 主入口；不是 OpenAI Sora multipart input_reference 原样透传接口，也不是 New API 通用视频协议 /v1/video/generations。
POST /api/v3/contents/generations/tasksapplication/json火山原接口仍支持火山方舟 Seedance 原生创建路径；保持官方字段风格，返回 { id }。

输入参数

参数类型必填说明
modelstring是支持 videos.generations 的视频模型编码，例如 4sdance431、4sdance933x。
promptstring推荐Gateway 视频提示词；火山 Seedance 写法也可使用 content[].text。
image_url / image_urlsstring | string[]Gateway 图生视频时Gateway JSON 扁平字段；单图用 image_url，多图用 image_urls。
start_image_url / end_image_urlstring首尾帧场景首帧 / 尾帧参考图 URL；Seedance 官方线路会转换为 content[].role=first_frame / last_frame。也兼容 first_frame / last_frame、first_frame_url / last_frame_url 别名。
video_url / video_referencestring | object[]视频参考时参考视频素材，按线路能力透传。
audio_url / audio_referencestring | object[]音频参考时参考音频素材，按线路能力透传。
contentobject[]火山 Seedance 写法火山方舟 Seedance 原生内容数组；文本提示词、参考图、音频、视频与样片任务 ID 可统一放在这里。
content[].typestringSeedance 内容块火山 Seedance 内容块类型，例如 text、image_url、audio_url、video_url、task_id。
content[].textstring文本块文本提示词。
content[].image_urlstring | object图片块图片 URL，可传字符串或 { url }；参考图用 role=reference_image，首尾帧用 role=first_frame / last_frame。4sdance431 最多 4 张，4sdance933x 最多 9 张，URL 需公开可访问。
content[].audio_urlstring | object音频块音频参考素材 URL，可传字符串或 { url }；通常搭配 role=reference_audio。4sdance431 最多 1 条且约 15 秒内，4sdance933x 最多 3 条且约 14 秒内。
content[].video_urlstring | object视频块视频参考素材 URL，可传字符串或 { url }；通常搭配 role=reference_video。两个模型均最多 3 条，4sdance431 总时长约 15 秒内，4sdance933x 总时长约 14 秒内。
content[].task_idstring任务块样片或上游任务 ID。
content[].rolestring素材块建议素材角色，例如 first_frame、last_frame、reference_image、reference_video、reference_audio。首尾帧场景需同时提供 first_frame 与 last_frame。
generate_audioboolean否火山 Seedance 生成参数；其他线路是否生效取决于模型能力。
aspect_ratio / ratiostring否aspect_ratio 是 Gateway 扁平字段；ratio 是火山 Seedance 原生字段。
duration / secondsinteger | string否视频时长，单位秒；seconds 是 Gateway 接收的兼容别名。
resolution / sizestring否视频分辨率档位；size 是 Gateway 接收的兼容别名。
seedinteger否随机种子，按上游能力支持情况透传。
watermarkboolean否火山 Seedance 生成参数；其他线路是否生效取决于模型能力。
asyncboolean否Gateway 扩展字段；视频本身采用任务语义。
callbackUrl / callback_urlstring否Gateway 扩展字段；任务完成后由 Gateway 发起回调。

视频比例与尺寸预设

视频参数推荐使用 resolution 档位与 aspect_ratio 组合；Gateway 在 NewAPI Seedance 线路会按下表转换为上游 size 像素尺寸。

比例 / aspect_ratioStandard / 480pHD / 720pFull HD / 1080p4K
16:9864x4961280x7201920x10803840x2160
1:1640x640960x9601440x14402880x2880
9:16496x864720x12801080x19202160x3840
4:3752x5601112x8341440x10802880x2160
3:4560x752834x11121080x14402160x2880

输出参数

参数类型返回说明
task_idstring是网关本地视频任务 ID；用于 GET /v1/videos/{taskId} 查询。
taskIdstring是同 task_id，返回给下游使用的网关本地任务 ID。
statusstring是pending / running / succeeded / failed / canceled。
createdinteger否任务创建时间，Unix 秒级时间戳。
data[].video_urlstring成功时生成视频 URL。
data[].urlstring兼容返回部分线路可能返回 url 字段表示视频地址。
usageobject否生成用量统计，字段按上游线路透传。
errorobject | string失败时失败原因。

补充说明

  • 火山方舟原生视频创建接口仍支持：POST /api/v3/contents/generations/tasks；如果你们已有火山链路，不需要强制改成 /v1/videos。
  • 视频生成只支持任务语义：提交后返回 task_id/taskId，任务完成后轮询 GET /v1/videos/{taskId} 获取 data[].video_url。
  • NewAPI 通用视频协议已开放独立路径 /v1/video/generations；本接口 /v1/videos 仍只声明 Gateway 视频任务字段。
  • 当前 /v1/videos 是 application/json Gateway 接口，不直接接收 OpenAI Sora 的 multipart input_reference 文件；请先取得图片 URL，再使用 image_url。
  • 推荐新接入使用 /v1/videos 的 prompt、image_url(s)、aspect_ratio、duration、resolution 等 Gateway 扁平字段。
  • 首尾帧推荐使用 start_image_url + end_image_url；Seedance 官方线路会自动转成 first_frame / last_frame 角色块，首尾帧模式不要和普通参考图、参考视频、参考音频混用。
  • Gemini Omni Flash Preview 等 Gemini 原生视频模型也可使用 /v1/videos；Gateway 会把扁平视频参数转换为 gemini.native.video 上游协议。
  • 4SDance 模型对外仍使用本接口：4sdance431 最多支持 4 张参考图、3 个参考视频、1 个参考音频，常用比例 16:9、9:16、1:1；4sdance933x 最多支持 9 张参考图、3 个参考视频、3 个参考音频，并支持 16:9、9:16、1:1、4:3、3:4、21:9、9:21 等比例。
  • 火山原生路径返回格式与 Gateway 主入口不同：创建接口返回 { id }，查询路径为 GET /api/v3/contents/generations/tasks/{id}。
  • 如果包含多张参考图，实际画幅通常继承首张参考图的原始宽高比；aspect_ratio/ratio 只能作为期望值参考，不能保证强制生效。

错误代码

HTTP 状态码错误说明
400Bad Request参数格式错误或模型不支持视频生成。
401UnauthorizedClient Key 无效或未提供。
402Payment RequiredClient Key 配额或消费限额超限。

在线调试

model
your-model-code

暂无 videos.generations 精确模型，按 video/视频/seedance 兜底展示

暂无可用模型 →
content[].text

视频文本提示词；示例会写入 content[] 的 text 内容块

更多配置视频参数callbackUrl=异步任务
callbackUrl
关
基础参数控制输出规格
参考素材每类素材可上传或粘贴 URL
图片image_url
reference_image
上传图片或粘贴图片 URL
视频video_url
reference_video
上传视频或粘贴视频 URL
音频audio_url
reference_audio
上传音频或粘贴音频 URL
curl -X POST 'https://api.4stoken.cn/v1/videos' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  --data-raw '{"model":"your-model-code","content":[{"type":"text","text":"城市夜景，车流光影，简约写实风格"}],"generate_audio":false,"ratio":"16:9","duration":6,"watermark":true,"resolution":"720p"}'

# Gateway 视频接口：提交后返回 task_id/taskId
# 视频生成只支持任务语义：轮询 GET /v1/videos/{taskId}
在线调试会向 Gateway 发起真实请求并可能产生费用。请确认参数无误后再点击。