视频生成

提交一次生成请求，查询进度，下载完成的视频。

视频生成通常需要等待。保存创建响应中的原任务 ID，后续查询和下载始终使用这一 ID。

创建任务

POST/v1/videos

以下是支持 duration、resolution 与 aspect_ratio 的文生视频模型示例。将 OCEANWAY_VIDEO_MODEL 设为支持该组合的已发布模型；其他模型使用详情页给出的请求格式。

curl --fail-with-body \
  --dump-header oceanway-video.headers \
  https://console.oceanway.tech/v1/videos \
  -H "Authorization: Bearer $OCEANWAY_API_KEY" \
  -H "Content-Type: application/json" \
  --data "{\"model\":\"$OCEANWAY_VIDEO_MODEL\",\"prompt\":\"航拍一片宁静的蓝色海岸，镜头缓慢前移，阳光洒在海面上。\",\"duration\":5,\"resolution\":\"480p\",\"aspect_ratio\":\"16:9\"}"

参数	含义	使用说明
model	视频模型 ID	从目录复制准确值
prompt	场景与镜头描述	提示词长度要求因模型而异
duration	请求生成时长	示例单位为秒，仅使用模型支持值
resolution	请求分辨率	支持档位因模型而异
aspect_ratio	请求画幅	仅使用模型支持比例

不要把一个模型的时长、分辨率、音频或参考图能力套用到其他模型。最终视频的实际时长、像素和声音以输出文件为准。

查询进度

GET/v1/videos/{id}

将创建响应中的 id 保存为 OCEANWAY_VIDEO_TASK_ID，使用原 Key 查询：

curl --fail-with-body \
  "https://console.oceanway.tech/v1/videos/$OCEANWAY_VIDEO_TASK_ID" \
  -H "Authorization: Bearer $OCEANWAY_API_KEY"

状态字段按模型任务协议返回。排队或处理中时继续查询原任务；显示完成后读取内容。若返回失败，读取对应错误说明。

建议以数秒间隔开始轮询，任务等待较久时逐步延长间隔。响应提供 Retry-After 时按该值等待。这是客户端建议，不代表固定服务端限额。

下载视频

GET/v1/videos/{id}/content

curl --fail-with-body \
  "https://console.oceanway.tech/v1/videos/$OCEANWAY_VIDEO_TASK_ID/content" \
  -H "Authorization: Bearer $OCEANWAY_API_KEY" \
  --output oceanway-video.mp4

先确认原任务已完成，再下载结果。接口支持的内容类型以响应头为准；需要保留的文件应保存到你自己的存储。

连接中断与重复提交

关闭客户端不会撤销已开始的生成。网络中断后，优先在 媒体任务 中确认原任务。不要把 HTTP 错误或等待时间过长理解为生成没有发生，也不要自动重新创建视频。