4SToken
API Reference

接口参考

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

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

视频生成

Seedance 官方标准协议兼容入口，统一返回 Gateway 本地视频任务 ID。

上一页 下一页

接口信息

请求地址https://api.4stoken.cn
请求路径/v1/videos
请求方式POST
Content-Typeapplication/json
鉴权Authorization: Bearer sk-...

输入参数

参数类型必填说明
modelstring是支持 videos.generations 的视频模型编码。
promptstring是视频生成提示词。
durationinteger否视频时长，单位秒，按 Seedance 官方协议透传。
aspect_ratiostring否宽高比，例如 16:9、9:16、1:1。
resolutionstring否分辨率档位，例如 720p / 1080p。
image_urlstring否图生视频参考图 URL。
reference_imagesstring[]否多参考图 URL。
seedinteger否随机种子。
watermarkboolean否是否加水印，按上游能力支持情况透传。
asyncboolean否Gateway 扩展；true 时立即返回 task_id，不透传到 Seedance 上游。
callbackUrlstring否Gateway 扩展；任务成功后回调，不透传到 Seedance 上游。

输出参数

参数类型返回说明
task_idstring是Gateway 本地视频任务 ID，通常为 vid-...。
taskIdstring是同 task_id。
statusstring是提交后通常为 pending。
data[].video_urlstring成功时视频结果 URL；临时链接会先镜像到 COS 后返回。
usageobject否上游返回的用量信息。

补充说明

  • async 与 callbackUrl 为 Gateway 控制字段，不会透传到 Seedance 官方上游。
  • 任务完成后轮询 GET /v1/videos/{taskId} 获取 data[].video_url。
  • 若上游返回异步临时链接，Gateway 会上传视频到 COS，保存并返回我们的 COS URL。

错误代码

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

示例

请求示例

{
  "model": "seedance-2-0-pro",
  "prompt": "海浪拍打礁石，电影感推镜",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "async": true,
  "callbackUrl": "https://your-app.com/hooks/gateway"
}

响应示例

{
  "task_id": "vid-202406010001",
  "taskId": "vid-202406010001",
  "status": "pending"
}