创建视频

创建 OpenAI/Sora 兼容格式的视频生成任务。该入口用于平台中配置为视频生成通道的模型，例如 sora-2、bytedance-seedance-1.5；具体可用模型以模型列表和账号渠道配置为准。

如果你要使用阿里百炼原生 input / parameters 请求格式，请看阿里视频生成。

Try It

POST/v1/videoshttps://api-platform.ope.ai

端点

端点	鉴权	用途
`POST /v1/videos`	`Authorization: Bearer <api-key>`	API Key 直接创建视频任务
`POST /api/videos`	`token: <jwt>`	前台令牌代理入口，请求体保持一致

普通前台 JWT 推荐放在 token 请求头；管理员 JWT 可使用 Authorization: Bearer <jwt>。

认证

使用 Bearer Token 认证。

Header：Authorization: Bearer <api-key>
示例：Authorization: Bearer sk-xxxxxx

请求体（application/json）

字段	类型	必填	说明
`model`	string	是	视频模型 ID，例如 `sora-2`、`bytedance-seedance-1.5`
`prompt`	string	是	文本提示词
`size`	string	是	输出尺寸，推荐使用 `widthxheight`，例如 `720x1280`
`seconds`	string	是	视频时长秒数字符串，例如 `"4"`；可用范围由具体模型决定
`generate_audio`	boolean	否	是否生成音频，适用于支持该能力的视频模型
`enhance_prompt`	boolean	否	是否增强提示词，适用于支持该能力的视频模型
`negative_prompt`	string	否	反向提示词
`person_generation`	string	否	人物生成策略，具体取值以模型能力为准
`seed`	integer	否	随机种子
`remix_video_id`	string	否	基于已有视频继续编辑时的视频任务 ID
`input_reference.content`	array	否	多模态参考内容；每项 `type` 仅支持 `image_url`、`video_url`、`audio_url`

input_reference.content[] 的结构如下：

字段	类型	必填	说明
`type`	string	是	`image_url`、`video_url` 或 `audio_url`
`role`	string	否	参考内容角色，例如 `reference_image`
`image_url.url`	string	条件必填	当 `type=image_url` 时传入图片 URL 或 Data URL
`video_url.url`	string	条件必填	当 `type=video_url` 时传入视频 URL
`audio_url.url`	string	条件必填	当 `type=audio_url` 时传入音频 URL

字段限制

平台会按后端校验规则拒绝这些不兼容字段：aspect_ratio、resolution、duration_seconds、顶层 content、JSON 请求里的 img_url，以及旧版 input_reference.file_id / input_reference.image_url。文本内容请放在 prompt，不要放入 input_reference.content[].text。

multipart/form-data 仅用于上传参考图片文件：字段名为 input_reference，文件大小不超过 10MB，支持 image/jpeg、image/png、image/webp。同一个请求不要同时传 input_reference 文件和 remix_video_id。

请求示例

cURL
JavaScript
Python

curl -X POST "https://api-platform.ope.ai/v1/videos" \
  -H "Authorization: Bearer $OPEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "生成展示 AI 视频生成能力的短片，科技感，高清。",
    "size": "720x1280",
    "seconds": "4"
  }'

const res = await fetch("https://api-platform.ope.ai/v1/videos", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.OPEAI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "sora-2",
    prompt: "生成展示 AI 视频生成能力的短片，科技感，高清。",
    size: "720x1280",
    seconds: "4",
  }),
});

console.log(await res.json());

import os
import requests

resp = requests.post(
    "https://api-platform.ope.ai/v1/videos",
    headers={"Authorization": f"Bearer {os.environ['OPEAI_API_KEY']}"},
    json={
        "model": "sora-2",
        "prompt": "生成展示 AI 视频生成能力的短片，科技感，高清。",
        "size": "720x1280",
        "seconds": "4",
    },
    timeout=120,
)

print(resp.json())

参考内容示例

{
  "model": "bytedance-seedance-1.5",
  "prompt": "让参考图片中的主体在镜头前自然转身，电影感光线。",
  "size": "1280x720",
  "seconds": "5",
  "input_reference": {
    "content": [
      {
        "type": "image_url",
        "role": "reference_image",
        "image_url": {
          "url": "https://example.com/reference.png"
        }
      }
    ]
  }
}

响应示例

创建接口会返回任务 ID，后续使用获取视频任务状态轮询任务，完成后再使用获取视频内容下载结果。

{
  "id": "video_690d9b52e2b081908a05ded32cbfc629",
  "object": "video",
  "status": "queued",
  "created_at": 1762499410,
  "model": "sora-2",
  "prompt": "生成展示 AI 视频生成能力的短片，科技感，高清。",
  "size": "720x1280",
  "seconds": "4"
}

Try It​

端点​

认证​

请求体（application/json）​

字段限制​

请求示例​

参考内容示例​

响应示例​