Skip to main content
POST
创建视频
已有 OpenAI SDK client.videos 集成时使用这个格式。支持文生视频和单张首帧图生视频,输出 720p。参考音频、多张参考图和视频编辑请使用 Ark / Seedance。

接入配置

OpenAI SDK 的 Base URL 填 https://api.aiohub.org/v1,API key 填完整的 AIOHub sk- API 令牌。这是视频接口,不使用 Chat Completions 或 Responses。

请求示例

把 <AIOHUB_API_KEY> 替换为完整 API 令牌。所选分组需包含示例中的 Seedance 模型。
创建响应的关键字段如下。保存 id,不要再次提交创建请求来查询进度。
拿到任务标识后,转到 查询任务。

参数范围

JSON 请求使用 application/json;上传图片文件时使用 multipart/form-data,文件字段为 input_reference。尺寸不匹配时先裁剪或缩放图片再提交。
安装 openai SDK,并在运行环境中设置 AIOHUB_API_KEY。示例只在生成成功后下载。
创建请求超时且未拿到任务标识时,先检查 用量日志,避免重复生成和扣费。400 错误需要先修正参数;401 错误请检查令牌。模型权限和额度见 鉴权。

授权

Authorization
string
header
必填

API key (sk-xxx)

请求体

model
string
必填

模型名称

示例:

"doubao-seedance-2-5-260628"

prompt
string
必填

提示词

示例:

"A blue ceramic cup on a wooden table in daylight, slow camera push-in."

seconds
string

生成秒数

示例:

"4"

size
string

视频尺寸

示例:

"1280x720"

input_reference
string

首帧图片的 HTTPS 地址或 data URL

示例:

"https://example.com/first.png"

响应

成功创建视频任务

id
string
必填

视频 ID

object
string
必填

对象类型

model
string
必填

使用的模型

status
string
必填

任务状态

progress
integer
必填

进度百分比

created_at
integer
必填

创建时间戳

seconds
string
必填

视频时长

completed_at
integer

完成时间戳

expires_at
integer

过期时间戳

size
string

视频尺寸

error
object

OpenAI 视频错误信息

metadata
object

额外元数据