个人项目

创建视频

开发中

POST

/sora/backend/video_gen

请求参数

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

视频宽度(像素)

必需

>= 1

height

number

视频高度(像素)

必需

>= 1

n_frames

number

视频帧数

必需

>= 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 --request POST '/sora/backend/video_gen' \
--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成功

text/plain

Body

object {0}

查询任务

查询视频