POST ひとつで、プロンプトや静止画が生成クリップになります。Veo、Kling、Sora、Seedance をひとつのエンドポイントの裏に。課金は生成単位、納品は Webhook。
POSThttps://autostud.ai/api/v1/actions/videos_ai.generateエンジンを一度選べば、あとは好きなだけ生成できます。
エージェントは保存済みのモデル設定です(エンジン、解像度、アスペクト比、既定値)。ワークスペースの一覧を取得して id を控えます。
export AUTOSTUD_API_KEY="sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# A video agent is a saved model configuration, not a model name.
curl "https://autostud.ai/api/v1/agents?agent_type=video&limit=10" \
-H "Authorization: Bearer $AUTOSTUD_API_KEY"テキストだけでも、動かしたい静止画でも構いません。レスポンスには生成 id と消費クレジットが入ります。
curl -X POST https://autostud.ai/api/v1/actions/videos_ai.generate \
-H "Authorization: Bearer $AUTOSTUD_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: lighthouse-shot-01" \
-d '{
"agent_id": "b21f7d90-3c44-4e1a-9f77-0c2ad5e6b118",
"prompt": "A lighthouse at dusk, slow push-in, waves breaking under it",
"duration": 8
}'generation.completed の Webhook を受けるか、ポーリング派なら生成を読み直します。ホスト済み URL はレコード上にあります。
# Register once. Every generation reports itself from then on.
curl -X POST https://autostud.ai/api/v1/webhooks \
-H "Authorization: Bearer $AUTOSTUD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://your-app.com/hooks/autostud",
"events": ["generation.completed", "generation.failed"],
"description": "AI video"
}'
# The signing secret comes back once, in this response. Store it.4 つのフィールドだけ。それ以外はエージェント側にあるので、呼び出しは短いままです。
agent_id実行する動画エージェント。エンジンと既定値が仕上がりを決めます。
promptそのカットで何が起きるか。エンジンは演出指示として読みます。
image_url任意。テキストだけで生成する代わりに、動かす静止画を渡します。
duration生成する尺(秒)。エンジンが対応する範囲内で指定します。
各エンジンはエージェントとして公開されます。モデルの切り替えは id の違いであって、実装の違いではありません。新しいエンジンは新しいエージェントとして増えます。
Webhook をひとつ登録すれば、各生成が自分から知らせます。ペイロードは署名付き・再送あり、失敗時も消費クレジットを含みます。
generation.completedgeneration.failedエンジンと尺によります。数秒の映像に数分の計算が必要です。呼び出しはすぐ id を返すので、アプリ側で待つ処理は要りません。
生成はクレジット課金で、単価はエンジンごとです。消費量はレスポンスに入り、履歴は /api/v1/generations で読めます。
できます。公開アクセスできる静止画を image_url に渡すと、プロンプトだけの生成ではなくその画像を動かします。
生成 id と続きのプロンプトで videos_ai.extend を呼びます。延長も 1 件の生成として同じように課金されます。