このAPIは準備中であり、まだ利用できません。以下はAPI仕様のプレビューです。正式リリース後に利用可能になります。
エンドポイント
POST https://omniakey.com/v1/videos/generations
リクエスト例
import requests
headers = {
"Authorization": "Bearer your-omniakey-api-key",
"Content-Type": "application/json"
}
# ステップ1：生成タスクを送信
response = requests.post(
"https://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://omniakey.com/v1/videos/generations/{task_id}",
headers=headers
)
result = status_response.json()
if result["status"] == "completed":
print(f"動画URL: {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://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"
}'
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 | 画像から動画、スタイル制御 |
| Kling 1.5 | Kuaishou | 10秒 | 720p, 1080p | 高速生成、良好なモーション |
| Pika 1.5 | Pika Labs | 5秒 | 720p, 1080p | スタイル化出力、リップシンク |
