创建视频

POST

{{BASE_URL}}/sora/v1/videos

视频生成/sora/官方格式

最后修改时间：2025-01-15 02:16:12

尺寸参数:
"480x480": "1:1",
"720x720": "1:1",
"480x854": "9:16",
"854x480": "16:9",
"1280x720": "16:9",
"720x1280": "9:16"

分辨率参数：
"480x480": "480p",
"720x720": "720p",
"480x854": "480p",
"854x480": "480p",
"1280x720": "720p",
"720x1280": "720p"

视频时长：
"150": "5s",
"300": "10s"

请求参数

Header 参数

Authorization

string

可选

示例值:

Bearer sk-xxx

Body 参数application/json

Schema for video generation request parameters

actions

array [object {2}]

可选

视频动作列表，定义视频中需要执行的一系列动作和时间点

time

number

必需

动作执行的时间点(秒)

description

string

动作描述

必需

inpaint_items

array [object {8}]

可选

图像修复项列表，定义需要进行修复或替换的视频帧区域

type

enum<string>

项目类型

可选

枚举值:

image

url

string

图像URL

可选

frame_index

number

目标帧索引

可选

preset_id

null

预设ID

可选

generation_id

null

生成ID

可选

upload_media_id

string

上传媒体ID

可选

source_start_frame

number

源视频起始帧

可选

source_end_frame

number

源视频结束帧

可选

type

enum<string>

生成类型

可选

枚举值:

video_gen

style

enum<string>

视频风格

可选

枚举值:

natural

prompt

string

可选

用于指导AI生成视频的文本描述

width

number

可选

视频宽度(像素) 480、854、720、1280

>= 1

height

number

可选

视频高度(像素) 480、854、720、1280

>= 1

n_frames

number

可选

视频帧数 150、300

>= 1

n_variants

number

生成变体数量

可选

>= 1

sdedit

object

可选

SDE(随机扩散编辑)相关配置

amount

number

编辑强度

必需

>= 1<= 8

source_generation_id

string

源生成ID

必需

source_upload_media_id

string | null

源上传媒体ID

必需

operation

enum<string>

操作类型

可选

枚举值:

simple_composestoryboardremixblend

model

enum<string>

使用的模型

可选

枚举值:

turbo

示例

{
  "type": "video_gen",
  "prompt": "fly man",
  "n_variants": 1,
  "n_frames": 150,
  "height": 480,
  "width": 854,
  "style": "natural",
  "inpaint_items": [
    {
      "url": "" // 图片 url，可选参数，如有图片，只需要填 url，inpaint_items 中的其他参数不需要，会自动获取
    }
  ],
  "operation": "simple_compose"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '{{BASE_URL}}/sora/v1/videos' \
--header 'Authorization: Bearer sk-xxx' \
--header 'Content-Type: application/json' \
--data-raw '{
  "type": "video_gen",
  "prompt": "fly man",
  "n_variants": 1,
  "n_frames": 150,
  "height": 480,
  "width": 854,
  "style": "natural",
  "inpaint_items": [
    {
      "url": "" // 图片 url，可选参数，如有图片，只需要填 url，inpaint_items 中的其他参数不需要，会自动获取
    }
  ],
  "operation": "simple_compose"
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{
  "code": "success",
  "message": "",
  "data": "task_01jhjnz502ejqsm6r37km2q637"
}

获取任务进度(免费

查询视频任务(免费