POST https://api.omniakey.com/v1/videos/generations
从文本描述生成视频。视频生成是异步过程 — 你提交任务后,轮询获取结果或通过 Webhook 接收完成通知。
请求示例
import requests
headers = {
"Authorization": "Bearer your-omniakey-api-key",
"Content-Type": "application/json"
}
# 步骤 1:提交生成任务
response = requests.post(
"https://api.omniakey.com/v1/videos/generations",
headers=headers,
json={
"model": "sora",
"prompt": "金毛犬在日落时分的海浪中玩耍",
"duration": 5,
"resolution": "1080p"
}
)
task = response.json()
task_id = task["id"]
print(f"任务已提交: {task_id}")
# 步骤 2:轮询结果
import time
while True:
status_response = requests.get(
f"https://api.omniakey.com/v1/videos/generations/{task_id}",
headers=headers
)
result = status_response.json()
if result["status"] == "completed":
print(f"视频链接: {result['output']['url']}")
break
elif result["status"] == "failed":
print(f"错误: {result['error']['message']}")
break
time.sleep(5) # 每 5 秒轮询一次
任务提交响应
{
"id": "vtask-abc123",
"status": "processing",
"created": 1709251200,
"model": "sora",
"estimated_time": 60
}
任务完成响应
{
"id": "vtask-abc123",
"status": "completed",
"created": 1709251200,
"model": "sora",
"output": {
"url": "https://api.omniakey.com/files/video-abc123.mp4",
"duration": 5,
"resolution": "1920x1080",
"format": "mp4"
}
}
任务状态值
| 状态 | 说明 |
|---|
pending | 任务已排队,等待开始 |
processing | 视频正在生成 |
completed | 视频已就绪,可以下载 |
failed | 生成失败(查看 error 字段) |
Webhook 通知
你可以提供一个 Webhook URL,在视频生成完成时接收通知,无需轮询:
curl https://api.omniakey.com/v1/videos/generations \
-H "Authorization: Bearer your-omniakey-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "sora",
"prompt": "金毛犬在日落时分的海浪中玩耍",
"duration": 5,
"webhook_url": "https://your-server.com/webhooks/video-ready"
}'
Webhook POST 请求的载荷与上面的任务完成响应格式相同。
请求参数
要使用的模型 ID。可选值:sora、runway-gen3、kling-1.5、pika-1.5。
期望视频的文本描述。为获得最佳效果,请详细描述主体、动作、环境、镜头角度和风格。
视频时长(秒)。范围取决于模型(通常 3-15 秒)。默认:5。
输出分辨率。可选值:720p、1080p。默认:1080p。并非所有模型支持所有分辨率。
宽高比。可选值:16:9、9:16、1:1。默认:16:9。
视频生成完成时接收 POST 请求的 URL。使用此参数代替轮询。
支持的模型
| 模型 | 供应商 | 最大时长 | 分辨率 | 特性 |
|---|
| Sora | OpenAI | 15 秒 | 720p, 1080p | 照片级真实感,文本生成视频 |
| Runway Gen-3 | Runway | 10 秒 | 720p, 1080p | 图生视频,风格控制 |
| 可灵 1.5 | 快手 | 10 秒 | 720p, 1080p | 快速生成,运动效果好 |
| Pika 1.5 | Pika Labs | 5 秒 | 720p, 1080p | 风格化输出,口型同步 |