引擎只挑一次,之後想生成幾次都行。
代理就是存好的模型設定:引擎、解析度、比例與預設值。列出你工作區裡的代理,記住 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,或者你偏好輪詢就再讀一次生成紀錄。託管網址就在紀錄上。
# 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.四個欄位。其餘都在代理身上,所以呼叫可以很短。
agent_id要執行的影片代理。它的引擎和預設值決定成品長什麼樣。
prompt這顆鏡頭裡該發生什麼。引擎會像導演一樣讀它。
image_url選填。要動起來的靜態圖,取代純文字生成。
duration要產生幾秒的畫面,範圍以引擎支援為準。
每個引擎都以代理形式公開:換模型只是換一個 id,不是換一套整合。新引擎會以新的代理出現。
註冊一個 webhook,每次生成都會自己回報。Payload 有簽章、會重試,即使生成失敗也會附上已花的點數。
generation.completedgeneration.failed看引擎和長度:幾秒的畫面要花上幾分鐘運算。呼叫會立刻回傳 id,所以你的應用不必等在那裡。
生成以點數計費,價格依引擎而定。每個回應都會回報花掉的點數,完整紀錄可在 /api/v1/generations 讀取。
可以。把任何可公開存取的靜態圖放進 image_url,引擎就會讓它動起來,而不是只依提示詞生成。
用生成 id 加上下一段的提示詞呼叫 videos_ai.extend。延長本身也是一次生成,計費方式相同。