ApiVideos
查询视频任务
轮询任务状态。任务处于非终态(`queued` / `running`)时,网关会实时回源查询 上游;已终态(`succeeded` / `failed`)则直接读本地记录。 建议轮询间隔 3–5 秒。 > 若上游临时查询失败,本端点**不会报错**,而是返回上一次已知状态。因此连续 > 几次拿到相同的 `queued` 属于正常现象。 任务不存在、或不属于当前账号,统一返回 `404`——不区分两者,以免泄露他人任务 是否存在。
轮询任务状态。任务处于非终态(queued / running)时,网关会实时回源查询
上游;已终态(succeeded / failed)则直接读本地记录。
建议轮询间隔 3–5 秒。
若上游临时查询失败,本端点不会报错,而是返回上一次已知状态。因此连续 几次拿到相同的
queued属于正常现象。
任务不存在、或不属于当前账号,统一返回 404——不区分两者,以免泄露他人任务
是否存在。
AuthorizationBearer <token>
Authorization: Bearer sk-juc-...
前缀必须是恰好 Bearer (首字母大写 + 单个空格)。bearer、BEARER
或用制表符分隔都会被判为无效。
除 API Key 外,也接受 OAuth 设备访问令牌(仅限 oauth_access 类型的 JWT;
普通网页会话令牌会被拒绝)。
In: header
Path Parameters
id*string
提交任务时返回的 id(UUID)。
Format
uuidResponse Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/videos/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "id": "3f8a1c2e-5b4d-4e6f-9a0b-1c2d3e4f5a6b", "object": "video.generation.job", "status": "running", "model": "wan2.2-t2v", "created_at": 1753440000}