创建视频

curl --request POST \
  --url https://api.deerapi.com/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form prompt=cat \
  --form input_reference='@example-file'

{
  "id": "<string>",
  "object": "<string>",
  "created_at": 123,
  "status": "<string>",
  "completed_at": null,
  "error": null,
  "expires_at": null,
  "model": "<string>",
  "progress": 123,
  "remixed_from_video_id": null,
  "seconds": "<string>",
  "size": "<string>"
}

​

概述

如果你是第一次接 DeerAPI 上的 Sora，默认就选当前页的官方格式。它和 OpenAI 官方 Videos API 的语义最接近，也是 DeerAPI 文档里默认推荐的 Sora 调用方式。 标准工作流是：

1. 调用当前页创建任务。
2. 用 检索视频 轮询状态。
3. 完成后按需调用 混编视频 或 下载视频。

​

官方格式和 tech 格式怎么选

如果你没有明确的 -all 兼容需求，请不要选 tech 页面。

​

这和 OpenAI 官方文档有什么差异

• 请求路径、模型名和核心参数与 OpenAI 官方 Videos API 基本对齐，但鉴权与域名统一换成了 DeerAPI：https://api.deerapi.com + Bearer Token。
• OpenAI 官方文档还会提到 webhook 等项目级能力；当前 DeerAPI 文档默认推荐的是更直接的轮询链路，也就是当前页创建后再调用查询页。
• OpenAI 官方最新文档同时提到 input_reference 文件上传和 image_reference 对象；DeerAPI 当前页优先记录经过当前聚合入口验证最稳定的 input_reference 上传方式。

​

参数怎么选最稳

• seconds：当前官方格式支持 4、8、12 秒。
• size：720x1280 和 1280x720 两个分辨率适合大多数场景；1024x1792、1792x1024 仅 sora-2-pro 支持。
• input_reference：需要参考图时，优先上传本地文件，并尽量让参考图尺寸和 size 对齐。

​

查询方式

创建成功后，服务端会立即返回任务对象。真正的成片状态请通过 检索视频 轮询，不要把当前页当成同步出视频接口。 推荐轮询间隔是 10 到 20 秒。任务完成后，再调用下载或混编页面。

​

常见限制

• 根据 OpenAI 官方最新视频生成文档，当前接口会拦截不适合未成年人观看的内容、受版权保护的角色与音乐，以及真人生成请求。
• 官方文档还明确提到：带有人脸的输入参考图当前会被拒绝。第一次调试参考图时，先不要用真人照片。
• 视频生成通常需要数分钟，模型、分辨率和排队情况都会影响时延。
• 官方文档说明下载资源的有效期通常只有大约 1 小时。任务完成后请尽快保存结果，不要把下载留到很晚。

​

常见问题

Q：视频生成需要多长时间？ A：通常需要几分钟到十几分钟，具体取决于视频时长、分辨率和服务器负载。如果长时间无响应或失败，请联系客服。 Q：支持哪些分辨率？ A：默认支持 720x1280。具体支持的分辨率请参考模型文档。 Q：生成的视频最长可以多长？ A：默认为 4 秒。最大时长取决于模型限制，请参考官方文档。 Q：如何提高生成质量？ A：使用详细的提示词，选择合适的时长，并提供高质量的参考图片。 格式要求：

• 每个镜头以 Shot N: 开头（N 为镜头编号）
• 使用 duration: Xsec 指定镜头时长
• 使用 Scene: 描述镜头内容
• 镜头之间用空行分隔