获取 API Key 获取 API
文档

Sora2 视频生成

- 异步处理模式,返回任务ID用于后续查询

  • 支持文本转视频、图生视频等多种生成模式
  • 支持 sora-2 与 sora-2-pro 两个模型
  • 生成的视频链接,有效期为24小时,请尽快保存

请求示例

curl --request POST \
  --url https://api.openveer.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2",
    "prompt": "瀑布倾泻而下形成彩虹",
    "duration": 8,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "image_urls": ["https://cdn.openveer.com/doc/9998238782946594-f62f70ce-348c-4b13-bb5f-15f17bee676b-image_task_01K88BEGZHVJWJ3ZV6HY99SWQR_0.png"]
  }'

响应示例

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

Authorizations

Authorization string

所有接口均需要使用Bearer Token进行认证

获取 API Key:

访问 API Key 管理页面 获取您的 API Key

使用时在请求头中添加:

Authorization: Bearer YOUR_API_KEY

Body

model string

视频生成模型名称

支持的模型:

  • sora-2 Sora 2 标准版
  • sora-2-pro Sora 2 Pro

示例:"sora-2"

prompt string

视频生成的文本描述

示例:"瀑布倾泻而下形成彩虹"

duration integer

支持的取值:4、8、12、16、20

示例:8

resolution string

视频分辨率

支持的取值:

模型 可传值
sora-2 720p
sora-2-pro 720p、1024p、1080p

不传时默认 720p。

示例:"720p"

aspect_ratio string

视频宽高比,控制横屏或竖屏

支持的取值:

方向 可传值
横屏 16:9、landscape
竖屏 9:16、portrait

不传时默认横屏。

警告

当传入 image_urls(图生视频)时,aspect_ratio 参数失效,无需上传;视频方向将依据参考图自动判定。

image_urls string

">
用于图生视频的参考图像 URL 数组

  • 不传为文生视频;传 1 张为图生视频
  • 最多 1 张
  • 支持公网可访问的图片 URL(http\:// 或 https\://)
  • 支持格式:.jpeg、.jpg、.png、.webp
  • 最大文件大小:10MB

示例:["https://example.com/image.jpg"]

Response

code integer

响应状态码,成功时为 200

data array
返回数据数组
status string

任务状态,初始提交时为 submitted

task_id string

任务唯一标识符,用于查询任务状态和结果