cicora.ai
API仕様非同期メディア

動画

動画生成は非同期ジョブとして開始し、ジョブIDを保持して、作成と結果の読み取りを分離します。

連携リファレンス:お使いの環境に合わせて、アカウントのAPI設定とモデルカタログからパラメーターおよび利用可能な機能を選択してください。

ジョブを作成

動画リクエストには通常、prompt、modelに加え、選択したモデルが対応している場合に限り、長さ、アスペクト比、解像度、参照素材などのフレーム関連プロパティを含めます。

ジョブIDは直ちに保存します。進捗の表示、インターフェースでのキャンセル対応、最終コンテンツの取得に必要です。

動画生成ジョブ
bash
curl --request POST https://cicora.ai/api/v1/videos \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "google/veo-3.1",
    "prompt": "Slow aerial movement above a river at sunrise",
    "duration": 8,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

ステータスをポーリング

  • GET /videos/{video_id}を使ってジョブを読み取ります。
  • 完了の判断では、終了ステータスを正とします。
  • ポーリング間隔を徐々に延ばし、ユーザーが画面を離れたら停止します。

結果を使用

完了後は、ジョブが返したURLまたはコンテンツを使用し、プレーヤーを表示する前にファイルが利用可能であることを確認します。

サポート用にprompt、model、パラメーター、ジョブIDを保持しますが、製品で必要な期間を超えて入力参照を保持しないでください。