引擎只選一次,隨便生成多少張,最後把文件收尾。
智能體就是一份保存好的配置:引擎、尺寸、風格,以及團隊定下的提示詞模板。列出工作區裡的智能體,記住它的 id。
export AUTOSTUD_API_KEY="sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# An image agent is a saved configuration, not a model name.
curl "https://autostud.ai/api/v1/agents?agent_type=image&limit=10" \
-H "Authorization: Bearer $AUTOSTUD_API_KEY"發送提示詞,以及模板需要的變量。響應裡帶著圖像和這次消耗的積分。
curl -X POST https://autostud.ai/api/v1/actions/images.generate \
-H "Authorization: Bearer $AUTOSTUD_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: sku-4471-packshot" \
-d '{
"agent_id": "a91d5f27-6c0b-4e83-97aa-2b1e4d70c6f9",
"prompt": "A ceramic mug seen three-quarter, soft studio light",
"variables": {
"product": "ceramic mug",
"color": "matte navy"
}
}'摳掉背景、按指令改圖,或者重新構圖成另一種畫幅。同一把密鑰、同一本賬,不需要第二次對接。
curl -X POST https://autostud.ai/api/v1/actions/tools.remove_background \
-H "Authorization: Bearer $AUTOSTUD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"image_url": "https://cdn.autostud.ai/generations/b6c30a19.../image.png"
}'三個字段用於生成,一個用於後期。
agent_id要運行的圖像智能體。引擎、尺寸和風格都跟著它走。
prompt要畫什麼,按你的智能體模板期待的方式書寫。
variables模板裡那些佔位符的取值,於是一個智能體就能服務整個商品目錄。
image_url給後期工具用的:要摳圖、改圖或裁剪的那張圖。只要公網能訪問即可。
每個引擎都以智能體的形式暴露,所以換模型只是換一個 id,不是換一套對接。新引擎會以新智能體的形式出現。
生成很少是最後一步。去背景、按指令編輯和重新構圖都是同一個 API 的操作,計費方式相同,也受同一把密鑰的範圍約束。
tools.remove_backgroundtools.image_modificationtools.image_crop每個響應都會報告消耗的積分,歷史記錄可以在 /api/v1/generations 讀到。價格按引擎計,在工作區裡設置,永遠不寫進請求。
變量正是為此而生:智能體保管模板和風格,調用填入變化的部分。一個商品目錄是一個智能體加 N 次調用,而不是 N 個智能體。
generation.completed 對圖像的觸發方式與視頻、音頻完全一致,所以一次訂閱就覆蓋整個生成家族。
可以。生成的地址能直接放進時間軸圖層,renders.create 再用同一把密鑰把整套構圖變成 mp4。