跳转到主要内容
POST
/
v1
/
videos
创建视频
curl --request POST \
  --url https://api.aiid.edu.kg/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form model=sora-2 \
  --form 'prompt=<string>' \
  --form image='@example-file' \
  --form duration=123 \
  --form width=512 \
  --form height=512 \
  --form fps=30 \
  --form seed=20231234 \
  --form n=1 \
  --form response_format=url \
  --form user=user-1234 \
  --form 'metadata={}' \
  --form 'mode=<string>' \
  --form 'images=<string>' \
  --form 'content={}' \
  --form 'size=<string>' \
  --form 'seconds=<string>' \
  --form 'input_reference=<string>' \
  --form 'parameters={}'
{
  "id": "video_abc123",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1764347090922,
  "seconds": "8"
}

授权

Authorization
string
header
必填

使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

请求体

model
enum<string>
必填

必填,对外模型名。 gemini-omni 可通过 /v1/videos 调用。

可用选项:
sora-2,
sora-2-pro,
gemini-omni,
happyhorse-1.0,
happyhorse-1.0-i2v,
happyhorse-1.0-t2v,
happyhorse-1.0-r2v,
happyhorse-1.0-video-edit,
doubao-seedance-1-0-lite-i2v-250428,
doubao-seedance-1-0-lite-t2v-250428,
doubao-seedance-1-0-pro-250528,
doubao-seedance-1-0-pro-fast-251015,
doubao-seedance-1-5-pro-251215,
doubao-seedance-2-0-260128,
doubao-seedance-2-0-fast-260128,
veo3,
veo3-fast,
veo3-fast-frames,
veo3-frames,
veo3-pro,
veo3-pro-frames,
veo3.1,
veo3.1-4k,
veo3.1-components,
veo3.1-fast,
veo3.1-pro,
veo3.1-pro-4k,
kling-video,
grok-imagine-1.0-video,
grok-imagine-video-1.5-preview,
grok-video-3,
viduq3-turbo,
hailuo-video
示例:

"sora-2"

prompt
string
必填

统一提示词入口。大多数模型必填。

image
file

单图入口,部分兼容模式会映射到 images。

duration
integer

统一时长入口,部分模型也接受 seconds。

width
integer

Video width

示例:

512

height
integer

Video height

示例:

512

fps
integer

Video frame rate

示例:

30

seed
integer

Random seed

示例:

20231234

n
integer

Number of videos to generate

示例:

1

response_format
string

Response format

示例:

"url"

user
string

User identifier

示例:

"user-1234"

metadata
object

动态扩展字段容器。大量模型特有字段从这里反序列化。

mode
string

可选,视频生成模式。 gemini-omni 支持 t2vr2vedit

images
string[]

统一多图入口。Vidu、Seedance、Veo 等会使用。

content
object[]
size
string

统一尺寸入口,会映射为 resolution/aspect_ratio 等。

seconds
string

Sora 兼容入口,运行时会回退到 duration。

input_reference
string

Sora/Veo 兼容参考图入口,可为 multipart 文件或兼容对象。

parameters
object

响应

成功创建视频任务

id
string
必填
object
string
必填
model
string
必填
status
enum<string>
必填

Should use VideoStatus constants: VideoStatusQueued, VideoStatusInProgress, VideoStatusCompleted, VideoStatusFailed

可用选项:
queued,
in_progress,
completed,
failed,
video_url,
url,
completed_at
progress
integer
必填
created_at
integer
必填
task_id
string

兼容旧接口 待废弃

completed_at
integer
expires_at
integer
seconds
string
size
string
remixed_from_video_id
string
error
object
metadata
object