APIAI 圖像生成 API

生成圖像
並在同一串調用裡做完後期

一次 POST 就跑起一個圖像智能體 —— GPT Image、Imagen、Nano Banana、Grok 或 Leonardo,而通常緊隨其後的摳圖、改圖和重新構圖,用同一把密鑰再調一次就好。

POSThttps://autostud.ai/api/v1/actions/images.generate

三次調用,從提示詞到成品素材

引擎只選一次,隨便生成多少張,最後把文件收尾。

  1. 1

    選一個圖像智能體

    智能體就是一份保存好的配置:引擎、尺寸、風格,以及團隊定下的提示詞模板。列出工作區裡的智能體,記住它的 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"
  2. 2

    生成

    發送提示詞,以及模板需要的變量。響應裡帶著圖像和這次消耗的積分。

    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"
        }
      }'
  3. 3

    把文件收尾

    摳掉背景、按指令改圖,或者重新構圖成另一種畫幅。同一把密鑰、同一本賬,不需要第二次對接。

    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,不是換一套對接。新引擎會以新智能體的形式出現。

GPT ImageImagenNano BananaGrokLeonardo

緊隨其後的工具

生成很少是最後一步。去背景、按指令編輯和重新構圖都是同一個 API 的操作,計費方式相同,也受同一把密鑰的範圍約束。

tools.remove_backgroundtools.image_modificationtools.image_crop

開發者最先問的問題

怎麼知道一張圖花了多少錢?

每個響應都會報告消耗的積分,歷史記錄可以在 /api/v1/generations 讀到。價格按引擎計,在工作區裡設置,永遠不寫進請求。

一個智能體能服務很多提示詞嗎?

變量正是為此而生:智能體保管模板和風格,調用填入變化的部分。一個商品目錄是一個智能體加 N 次調用,而不是 N 個智能體。

圖像也通過 Webhook 送達嗎?

generation.completed 對圖像的觸發方式與視頻、音頻完全一致,所以一次訂閱就覆蓋整個生成家族。

生成的圖像能用在視頻裡嗎?

可以。生成的地址能直接放進時間軸圖層,renders.create 再用同一把密鑰把整套構圖變成 mp4。

準備好開始了嗎?

幾分鐘就能產出爆紅影片。免費試用不需要信用卡。

安全付款
立即使用
隨時取消