接入文档
把任意 OpenAI 协议兼容的客户端指到下面的地址,用访问令牌鉴权。
关键信息
- 接口地址
-
https://video.tokenvalid.com - 认证方式
Authorization: Bearer sk-...- 协议
-
POST /api/v3/contents/generations/tasks
提交、轮询、取片
- 提交:POST /api/v3/contents/generations/tasks,返回任务号。尺寸、分辨率档、收费模式都写在请求里,不用换模型名。
- 轮询:GET /api/v3/contents/generations/tasks/{id},直到状态终结。不支持回调。
- 状态:queued / running 继续轮询;succeeded 从 content.video_url 下载成片;failed 看 error.message。
- 失败与内容审核拒绝都会自动退款;内容审核拒绝是终态,请改提示词后重发。
content 条目与 role
三种场景互斥:图生视频 / 首尾帧 / 多模态参考。
- 提示词(必带一条)
- 首帧(图生视频;单图可省略 role)
- 尾帧(与 first_frame 成对)
- 参考图(多模态参考;张数上限见下方规格表)
- 参考视频(仅 URL)
- 参考音频(须搭配参考图或参考视频)
家族与规格
登录后显示完整规格。
请求示例
curl https://video.tokenvalid.com/api/v3/contents/generations/tasks \
-H "Authorization: Bearer $XTOKEN_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "video-test",
"content": [{"type": "text", "text": "a paper crane unfolding"}]
}'
视频是异步的:先提交任务,再轮询到终态。