创建视频生成任务

post/v1/video/generations

提交视频生成任务，支持文生视频和图生视频。

返回任务 ID，可通过 GET 接口查询任务状态。

鉴权

把 OLETOKEN 的 API Key 作为 Bearer Token 放进 Authorization 请求头。密钥在控制台的「API 密钥」页创建。

Authorization: Bearer $OLETOKEN_API_KEY

请求体

Content-Type：application/json

字段	类型	必填	说明
model	`string`	—	模型/风格 ID
prompt	`string`	—	文本描述提示词
image	`string`	—	图片输入 (URL 或 Base64)
duration	`number`	—	视频时长（秒）
width	`integer`	—	视频宽度
height	`integer`	—	视频高度
fps	`integer`	—	视频帧率
seed	`integer`	—	随机种子
n	`integer`	—	生成视频数量
response_format	`string`	—	响应格式
user	`string`	—	用户标识
metadata	`object`	—	扩展参数 (如 negative_prompt, style, quality_level 等)

响应

200成功创建视频生成任务

字段	类型	必填	说明
task_id	`string`	—	任务 ID
status	`string`	—	任务状态

400请求参数错误

字段	类型	必填	说明
error	`object`	—	—
message	`string`	—	错误信息
type	`string`	—	错误类型
param	`string \| null`	—	相关参数
code	`string \| null`	—	错误代码

请求示例

curl -X POST 'https://api.oletoken.ai/v1/video/generations' \
  -H "Authorization: Bearer $OLETOKEN_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "kling-v1",
    "prompt": "宇航员在月球上漫步",
    "duration": 5,
    "width": 1280,
    "height": 720
  }'