4SToken
API Reference

接口参考

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

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

NewAPI 视频任务创建

NewAPI 通用 JSON 视频生成入口；支持文生视频、单图图生视频和模型支持范围内的多图参考，提交后返回 task_id，并通过 GET /v1/video/generations/{task_id} 查询状态和结果。

上一页下一页

接口信息

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

输入参数

接口清单

参数类型必填说明
POST /v1/video/generationsapplication/jsonNewAPI JSONNewAPI 通用视频创建路径；请求字段为 model、prompt、image/images、duration、width、height 等 JSON 字段。
GET /v1/video/generations/{task_id}path任务查询使用创建接口返回的 task_id 查询任务状态与视频 URL。

输入参数

参数类型必填说明
modelstring是Portal 发布的视频模型编码；Gateway 会映射到上游视频模型。
promptstring推荐文本提示词；文生视频和图生视频均可传。
imagestring单图图生视频时单张图片输入，支持 URL 或 Base64；Gateway 会按单图参考处理。
imagesstring[]多图参考时NewAPI 多图兼容字段；传多张参考图 URL 或 Base64。实际支持张数、首尾帧或主体参考语义取决于模型和上游渠道。
durationnumber否视频时长，单位秒。
widthinteger否期望视频宽度，例如 1280。
heightinteger否期望视频高度，例如 720。
fpsinteger否视频帧率，例如 30。
seedinteger否随机种子。
ninteger否生成视频数量。
response_formatstring否响应格式，通常使用 url。
userstring否终端用户标识，便于业务侧追踪。
metadataobject否扩展参数，例如 negative_prompt、style、quality_level 等，按模型线路能力透传。

输出参数

参数类型返回说明
task_idstring是视频生成任务 ID。
statusstring是queued / in_progress / completed / failed。

补充说明

  • 这是 NewAPI 通用 JSON 风格接口，不是 OpenAI Sora / NewAPI Sora 的 /v1/videos multipart input_reference 协议。
  • NewAPI 多图使用顶层 images: string[]；只传 image 时按单张参考图处理。
  • NewAPI 传入 width + height 时，Gateway 会归一为内部 size/resolution=宽x高，便于分辨率选路与上游适配。
  • 多图能力不是所有视频模型的统一保证：部分线路会把前两张作为首尾帧，部分线路只消费第一张，具体数量和语义以模型能力为准。
  • 任务完成后使用 GET /v1/video/generations/{task_id} 查询，成功时视频地址位于 url。
  • Gateway 会把内部 pending / running / succeeded / failed 状态归一为 NewAPI 的 queued / in_progress / completed / failed。

错误代码

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

在线调试

model
your-model-code

仅展示该接口支持的已发布模型

暂无可用模型 →
user message

对话用户消息 content

curl -X POST 'https://api.4stoken.cn/v1/video/generations' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  --data-raw '{"model":"your-model-code","prompt":"Hello","duration":6,"width":1280,"height":720,"fps":30,"n":1,"response_format":"url"}'

# NewAPI 通用 JSON 视频接口：提交后返回 task_id
# 轮询 GET /v1/video/generations/{task_id} 获取 status/url
在线调试会向 Gateway 发起真实请求并可能产生费用。请确认参数无误后再点击。