Ori联系我们

文档OriHub

查询视频或任务状态

方舟格式:查任务进度和成片地址。

拿到任务 id 后轮询这个接口。

请求

curl "https://api.lk888.ai/api/v3/contents/generations/tasks/cgt-20260414114820-xxxxx" \
  -H "Authorization: Bearer $OPENAI_API_KEY"

响应字段

字段 含义
id 任务 id
status queued / running / succeeded / failed
error 失败原因,成功时为 null
content.video_url 成片地址,成功后才有
content.last_frame_url 尾帧图地址
content.file_url 成品文件地址
usage completion_tokens / total_tokens;usage.tool_usage.web_search 是搜索次数,为 0 就是没搜
duration 视频时长(整数秒)
ratio / resolution 实际生效的比例与清晰度
generate_audio / output_format 是否带声、输出格式
framespersecond 帧率
created_at / updated_at 时间戳
draft 是否是草稿任务

下载

方舟格式没有单独的下载接口,成片地址就在响应的 content.video_url 里,拿到直接下:

curl -L -o out.mp4 "<content.video_url>"

两点注意

  • duration 是整数秒,可能比实际短 —— 它按「总帧数 ÷ 24 向下取整」算,比如 133 帧实际 5.54 秒,返回的就是 5。视频时长跟计费有关,duration: -1 让模型自己选的时候尤其要留意
  • 任务 id 只保留 7 天,过期就查不到了

失败了就看 error;能不能重试跟媒体协议那边一样,看错误分类。