Skip to main content

接口

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 请求的载荷与上面的任务完成响应格式相同。

请求参数

model
string
required
要使用的模型 ID。可选值:sorarunway-gen3kling-1.5pika-1.5
prompt
string
required
期望视频的文本描述。为获得最佳效果,请详细描述主体、动作、环境、镜头角度和风格。
duration
integer
视频时长(秒)。范围取决于模型(通常 3-15 秒)。默认:5
resolution
string
输出分辨率。可选值:720p1080p。默认:1080p。并非所有模型支持所有分辨率。
aspect_ratio
string
宽高比。可选值:16:99:161:1。默认:16:9
webhook_url
string
视频生成完成时接收 POST 请求的 URL。使用此参数代替轮询。

支持的模型

模型供应商最大时长分辨率特性
SoraOpenAI15 秒720p, 1080p照片级真实感,文本生成视频
Runway Gen-3Runway10 秒720p, 1080p图生视频,风格控制
可灵 1.5快手10 秒720p, 1080p快速生成,运动效果好
Pika 1.5Pika Labs5 秒720p, 1080p风格化输出,口型同步

查看全部模型

查看完整列表