DeerAPI-API文档
  1. 官方
DeerAPI-API文档
  • 快速开始
    • 快速开始
    • 入门必看
    • DeerAPI 公告
  • API 参考
    • 报错状态码说明
    • OpenAI格式
      • Chat Completions
      • Responses
      • gpt-4o-image生图
      • 图像
      • 图像编辑(gpt-image-1)
      • Embeddings
      • 获取模型列表
      • response id获取结果
      • Hunyuan3D
    • Anthropic 格式
      • Anthropic Claude
    • Gemini
      • 调用 gemini-3-pro-image 指南
      • Gemini生图
      • Gemini 文本对话
    • Midjourney 图像生成
      • Midjourney API 快速入门
      • 任务查询
        • 分页查询
        • 指定ID获取任务
      • 提交Imagine任务
      • 提交视频任务
      • 提交编辑任务
      • 提交Action任务
      • 提交Blend任务
      • 提交Describe任务
      • 提交Modal
    • 图像生成
      • Replicate(image)
        • 创建任务-通用
        • 查询任务
      • 豆包生图
        • seedream 图像生成
        • seededit 图像编辑
      • Flux(images)
        • 创建任务-replicate格式
        • 生成图片
        • 查询任务
        • 生成图片(replicate格式)
    • 音乐生成
      • Suno
        • 设置 suno 版本
        • Suno API 场景应用指南
        • 生成歌词
        • 生成音乐
        • 上传音乐
        • 歌曲拼接
        • 全轨声曲分离
        • 单轨声曲分离
        • 新建 Persona
        • 拓展 style tags
        • 查询单个任务
        • 生成 mp4 mv 视频
        • 获取 wav 格式文件
        • Timing:歌词、音频时间线
        • 批量查询任务
        • 获取 midi
        • 获取 vox
    • 视频生成
      • sora-2
        • 官方
          • 创建视频
            POST
          • 混编视频
            POST
          • 检索视频
            GET
          • 下载视频
            GET
        • 技术手段
          • 技术手段
            • sora自研异步创建
            • sora自研异步查回
      • veo3
        • 逆向异步格式
          • veo3逆向异步
          • veo3逆向查回
        • veo3-chat格式
      • kling (video)
        • Callback协议
        • 多模态视频编辑
          • 初始化待编辑视频
          • 增加视频选区
          • 删减视频选区
          • 清除视频选区
          • 预览已选区视频
          • 创建任务
        • 文生视频
        • 图生视频
        • Omni 视频
        • Omni 查询
        • 多图参考生视频
        • 视频延长
        • 语音合成
        • Kling 数字人创建任务
        • 【对口型】人脸识别
        • 【对口型】创建任务
        • 视频特效
        • 文生音效
        • 视频生音效
        • 图像生成
        • 多图参考生图
        • 扩图
        • 图像识别
        • 虚拟试穿
        • 查询任务(单个)
      • runway(video)
        • 逆向格式
          • generate(文本)
          • generate(参考图片)
          • video2video 视频转视频 风格重绘
          • Act-one 表情迁移
          • feed-获取任务
      • MiniMax 海螺(video)
        • 官方文档
        • 视频生成
        • 查询任务
        • 文件下载
      • luma (video)
        • 官方API格式
          • 生成视频
          • 单个查询任务
    • 音频
      • 文本转音频
      • 音频转文本
      • 创建翻译
  • 代码示例
    • 代码示例
  • 集成指南
    • 应用集成指南
      • OpenClaw
      • DeerAPI 本站调用
      • CodeX
      • OpenManus
      • Chatbox
      • CherryStudio
      • COZE
      • Cursor
      • Lobe-Chat
      • NEXT CHAT (ChatGPT Next Web)
      • AnythingLLM
      • cline
      • gptme
      • LangChain
      • ChatHub
      • ChatAll
      • Dify
      • Zotero
      • librechat
      • avante.nvim
      • IntelliJ Translation Plugin
      • FastGPT
      • OpenAI Translator
      • Open WebUI
      • obsidian的text generator插件
      • STranslate
      • 沉浸式翻译
      • Pot 翻译
      • 欧陆翻译
      • GPT 学术优化(gpt_academic)
      • utools-ChatGPT 好友
      • 懒人客服
    • 最佳实践
      • Claude code 接入说明
      • Deerapi 账户余额查询API 使用说明
      • 使用 DeerAPI 和 OpenAI 官方 API 的重试逻辑说明文档
      • Midjorney调用最佳实践
      • Runway调用最佳实践
  • 定价计费
    • 关于价格
    • 关于分组
  • 帮助中心
    • 帮助中心
    • 接口稳定性
    • 常见误区
    • 使用困惑
    • 隐私政策
    • 服务条款
  1. 官方

创建视频

POST
https://api.deerapi.com/v1/videos

概述#

videos 是 OpenAI Sora 的视频生成接口,通过文本提示词或可选的参考图片输入来创建视频生成任务。创建后,您需要使用查询接口获取生成状态。
任务完成后,您可以进行后续操作,如混剪和下载。
更多关于 Sora 生成接口的信息,请参阅 OpenAI 官方文档

支持的模型#

当前支持的模型 ID:sora-2 sora-2-pro

重要说明#

⚠️ 异步处理
视频生成需要较长时间,采用异步模式。创建任务后会立即返回任务 ID,您需要使用查询接口获取生成进度和结果。
⚠️ 内容政策
生成的视频内容必须符合 OpenAI 的使用政策。禁止生成违法、暴力、色情或侵犯版权的内容。
⚠️ 审核错误
如果您收到 Your request was blocked by our moderation system. 错误,这是 OpenAI 官方审核系统因入参不符合规范而返回的报错。请调整您的请求参数(如修改提示词内容、更换参考图片)后重试。

最佳实践#

1.
提示词优化:使用具体、详细的描述,包括场景、动作、光线等细节
2.
时长控制:根据内容复杂度选择合适的时长;较短的时长通常能获得更好的质量
3.
分辨率选择:根据使用场景选择合适的分辨率,平衡质量和生成时间
4.
图片预处理:使用图片引导时,确保输入图片清晰、构图合理
5.
错误处理:实现完善的重试和错误处理机制
6.
资源管理:及时下载生成的视频,避免资源过期

常见问题#

Q:视频生成需要多长时间?
A:通常需要几分钟到十几分钟,具体取决于视频时长、分辨率和服务器负载。如果长时间无响应或失败,请联系客服。
Q:支持哪些分辨率?
A:默认支持 720x1280。具体支持的分辨率请参考模型文档。
Q:生成的视频最长可以多长?
A:默认为 4 秒。最大时长取决于模型限制,请参考官方文档。
Q:如何提高生成质量?
A:使用详细的提示词,选择合适的时长,并提供高质量的参考图片。
格式要求:
每个镜头以 Shot N: 开头(N 为镜头编号)
使用 duration: Xsec 指定镜头时长
使用 Scene: 描述镜头内容
镜头之间用空行分隔

请求参数

Header 参数

Body 参数multipart/form-data

返回响应

🟢200Successful Response
application/json
Body

请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.deerapi.com/v1/videos' \
--header 'Authorization: ' \
--form 'prompt="cat"' \
--form 'model="sora-2"' \
--form 'seconds="4"' \
--form 'size="1024x1792"'
响应示例响应示例
{
    "id": "video_68e688d4950481918ec389280c2f78140fcb904657674466",
    "object": "video",
    "created_at": 1759938772,
    "status": "queued",
    "completed_at": null,
    "error": null,
    "expires_at": null,
    "model": "sora-2",
    "progress": 0,
    "remixed_from_video_id": null,
    "seconds": "4",
    "size": "720x1280"
}
修改于 2026-02-03 05:21:11
上一页
获取 vox
下一页
混编视频
Built with