APIAI 图像生成 API

生成图像
并在同一串调用里做完后期

一次 POST 就跑起一个图像智能体 —— GPT Image、Imagen、Nano Banana、Grok 或 Leonardo，而通常紧随其后的抠图、改图和重新构图，用同一把密钥再调一次就好。

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

三次调用，从提示词到成品素材

引擎只选一次，随便生成多少张，最后把文件收尾。

选一个图像智能体

智能体就是一份保存好的配置：引擎、尺寸、风格，以及团队定下的提示词模板。列出工作区里的智能体，记住它的 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，不是换一套对接。新引擎会以新智能体的形式出现。

GPT ImageImagenNano BananaGrokLeonardo

紧随其后的工具

生成很少是最后一步。去背景、按指令编辑和重新构图都是同一个 API 的操作，计费方式相同，也受同一把密钥的范围约束。

tools.remove_backgroundtools.image_modificationtools.image_crop

开发者最先问的问题

怎么知道一张图花了多少钱？

每个响应都会报告消耗的积分，历史记录可以在 /api/v1/generations 读到。价格按引擎计，在工作区里设置，永远不写进请求。

一个智能体能服务很多提示词吗？

变量正是为此而生：智能体保管模板和风格，调用填入变化的部分。一个商品目录是一个智能体加 N 次调用，而不是 N 个智能体。

图像也通过 Webhook 送达吗？

generation.completed 对图像的触发方式与视频、音频完全一致，所以一次订阅就覆盖整个生成家族。

生成的图像能用在视频里吗？

可以。生成的地址能直接放进时间轴图层，renders.create 再用同一把密钥把整套构图变成 mp4。

OpenAPI 規格錯誤代碼查看 API

準備好開始了嗎？

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

免費開始

或觀看範例

安全付款

立即使用

隨時取消

生成图像并在同一串调用里做完后期