提交视频生成任务
**异步端点。** 立即返回一个任务对象,不等待视频生成完成。拿到 `id` 后轮询 `GET /v1/videos/{id}` 获取结果。 这不是 OpenAI 标准端点,请求与响应形状是 JuCode 自定义的。 ### 文生视频 vs 图生视频 请求中带 `image_url`(或 `image`)时自动切换为图生视频;否则为文生视频。 ### 计费 **提交时不计费**,任务成功完成后按上游返回的实际时长结算。任务失败不计费, 无需申请退款。提交时只做一次余额预检。 ### 支持的上游 已接入 9 个厂商:阿里云万相、火山方舟 Seedance、智谱 CogVideoX、SiliconFlow、 MiniMax 海螺、Google Veo、可灵、Vidu、即梦。具体走哪家由模型路由决定。
异步端点。 立即返回一个任务对象,不等待视频生成完成。拿到 id 后轮询
GET /v1/videos/{id} 获取结果。
这不是 OpenAI 标准端点,请求与响应形状是 JuCode 自定义的。
文生视频 vs 图生视频
请求中带 image_url(或 image)时自动切换为图生视频;否则为文生视频。
计费
提交时不计费,任务成功完成后按上游返回的实际时长结算。任务失败不计费, 无需申请退款。提交时只做一次余额预检。
支持的上游
已接入 9 个厂商:阿里云万相、火山方舟 Seedance、智谱 CogVideoX、SiliconFlow、 MiniMax 海螺、Google Veo、可灵、Vidu、即梦。具体走哪家由模型路由决定。
Authorization: Bearer sk-juc-...
前缀必须是恰好 Bearer (首字母大写 + 单个空格)。bearer、BEARER
或用制表符分隔都会被判为无效。
除 API Key 外,也接受 OAuth 设备访问令牌(仅限 oauth_access 类型的 JWT;
普通网页会话令牌会被拒绝)。
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/videos" \ -H "Content-Type: application/json" \ -d '{ "model": "wan2.2-t2v", "prompt": "一列蒸汽火车穿过秋天的山谷,航拍镜头", "size": "1280x720", "duration": 5 }'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "object": "video.generation.job", "status": "queued", "model": "string", "created_at": 0, "video_url": "string", "seconds": 0, "error": { "message": "string" }}重排文档 POST
按查询相关性对候选文档重新排序,常用于 RAG 检索后的精排。请求原样透传, 字段语义遵循上游厂商(Jina / Cohere / SiliconFlow 等)的约定。
查询视频任务 GET
轮询任务状态。任务处于非终态(`queued` / `running`)时,网关会实时回源查询 上游;已终态(`succeeded` / `failed`)则直接读本地记录。 建议轮询间隔 3–5 秒。 > 若上游临时查询失败,本端点**不会报错**,而是返回上一次已知状态。因此连续 > 几次拿到相同的 `queued` 属于正常现象。 任务不存在、或不属于当前账号,统一返回 `404`——不区分两者,以免泄露他人任务 是否存在。