Gateway Protocols多标准协议兼容
OpenAIAnthropicGeminiOpenRouter
Chat / Responses / Messages / Claude MessagesGET /v1/video/generations/{task_id}
NewAPI 视频任务查询
查询 NewAPI 视频生成任务状态和结果；完成时返回顶层 url、format 和 metadata。
接口信息
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
task_id | string | 是 | 路径参数，POST /v1/video/generations 返回的任务 ID。 |
输出参数
| 参数 | 类型 | 返回 | 说明 |
|---|---|---|---|
task_id | string | 是 | 视频生成任务 ID。 |
status | string | 是 | queued / in_progress / completed / failed。 |
url | string | 成功时 | 生成视频资源 URL。 |
format | string | 成功时 | 视频格式，例如 mp4。 |
metadata | object | 按需返回 | 结果元数据，例如 duration、fps、width、height、seed。 |
error.code | integer | string | 失败时 | 错误码。 |
error.message | string | 失败时 | 错误信息。 |
补充说明
- NewAPI 查询响应把视频 URL 放在顶层 url；Gateway 主查询接口 GET /v1/videos/{taskId} 则放在 data[].video_url。
- 如果你们已有 NewAPI 客户端，优先使用本路径；如果是新业务统一接入 4SToken，推荐评估 /v1/videos 的 Gateway 视频任务格式。
错误代码
| HTTP 状态码 | 错误 | 说明 |
|---|---|---|
401 | Unauthorized | Client Key 无效或未提供。 |
404 | Not Found | 任务不存在或不可访问。 |
在线调试
user message对话用户消息 content
curl -X GET 'https://api.4stoken.cn/v1/video/generations/img-your-task-id' \ -H 'Authorization: Bearer YOUR_API_KEY'
在线调试会向 Gateway 发起真实请求并可能产生费用。请确认参数无误后再点击。
