Sora 動画生成
AceDataCloudのOpenAI Sora APIを使用してAI動画を生成します。
セットアップ: トークンの設定については認証を参照してください。
クイックスタート
curl -X POST https://api.acedata.cloud/sora/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt": "夕日が沈むビーチで走るゴールデンレトリバー", "model": "sora-2", "callback_url": "https://api.acedata.cloud/health"}'
非同期: 非同期タスクポーリングを参照してください。
POST /sora/tasksで{"id": "..."}を指定してポーリングします。
モデル
| モデル | 再生時間 | 品質 | 最適な用途 |
|---|---|---|---|
sora-2 | 10~15秒 | 標準 | ほとんどのタスク(デフォルト) |
sora-2-pro | 10~25秒 | 高品質 | プレミアム品質、長めの動画 |
ワークフロー
1. テキスト-to-ビデオ
POST /sora/videos
{
"prompt": "ネオンサインが雨の水たまりに反射する、夜の賑やかな東京の街並み",
"model": "sora-2",
"size": "small",
"duration": 10,
"orientation": "landscape"
}
2. 画像-to-ビデオ
参照画像を使用して生成をガイドします。
POST /sora/videos
{
"prompt": "シーンが徐々に穏やかな動きで活気づく",
"image_urls": ["https://example.com/scene.jpg"],
"model": "sora-2",
"orientation": "landscape"
}
3. キャラクター駆動ビデオ
既存の動画からキャラクターを抽出し、新しいシーンで使用します。
POST /sora/videos
{
"prompt": "キャラクターが未来的な街を歩く",
"character_url": "https://example.com/source-video.mp4",
"character_start": 2.0,
"character_end": 5.0,
"model": "sora-2-pro"
}
パラメータ
| パラメータ | 値 | 説明 |
|---|---|---|
model | "sora-2", "sora-2-pro" | 使用するモデル(必須) |
size | "small", "large" | 動画の解像度 |
duration | 10, 15, 25 | 再生時間(秒)。25はsora-2-proのみ |
orientation | "landscape" (16:9), "portrait" (9:16), "square" (1:1) | 動画の向き |
version | "1.0" | APIバージョン — バージョン1.0では最大25秒の再生時間、向き、キャラクター参照、画像入力が有効になります |
注意点
- 25秒の再生時間は
sora-2-proモデルでのみ利用可能です size: "large"は高解像度ですが、コストと時間がかかります- キャラクター駆動生成には、ソース動画からの
character_startおよびcharacter_endタイムスタンプ(秒単位)が必要です orientationでアスペクト比を設定 — モバイルファーストのコンテンツには"portrait"を使用- タスクステータスは
"succeeded"("completed"ではありません) — ポーリング時にはこの値を確認してください
MCP:
pip install mcp-sora| ホスティング:https://sora.mcp.acedata.cloud/mcp| すべてのMCPサーバーを参照