APIAPI de Geração de Imagens IA

Gere imagens
e termine-as na mesma cadeia de chamadas

Um POST executa um agente de imagem - GPT Image, Imagen, Nano Banana, Grok ou Leonardo - e os passos que costumam vir a seguir, recorte, edição e reenquadramento, ficam a uma chamada com a mesma chave.

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

Obter uma chave API Referência da API

Três chamadas, do prompt ao recurso final

Escolha o motor uma vez, gere as vezes que quiser e depois termine o ficheiro.

Escolha um agente de imagem

Um agente é uma configuração guardada: motor, tamanho, estilo e o modelo de prompt que a sua equipa acordou. Liste os do seu espaço de trabalho e guarde o 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"

Gere

Envie o prompt e as variáveis que o modelo espera. A resposta traz a imagem e os créditos que gastou.

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

Termine o ficheiro

Recorte o fundo, aplique uma edição por instrução ou reenquadre para outro formato. Mesma chave, mesmo registo, sem uma segunda integração.

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

O que pode enviar

Três campos para gerar, um para pós-processar.

agent_id

O agente de imagem a executar. O motor, o tamanho e o estilo vêm com ele.

prompt

O que desenhar, escrito como o modelo do seu agente espera.

variables

Os valores dos marcadores desse modelo, para que um só agente sirva um catálogo inteiro.

image_url

Para as ferramentas de acabamento: a imagem a recortar, editar ou cortar. Qualquer uma publicamente acessível.

Os motores por trás do endpoint

Cada motor é exposto como um agente, por isso mudar de modelo é outro id, não outra integração. Motores novos aparecem como agentes novos.

GPT ImageImagenNano BananaGrokLeonardo

As ferramentas que vêm a seguir

Gerar raramente é o último passo. Remover o fundo, editar por instrução e reenquadrar são ações da mesma API, faturadas do mesmo modo e limitadas pela mesma chave.

tools.remove_backgroundtools.image_modificationtools.image_crop

O que os programadores perguntam primeiro

Como sei quanto custou uma imagem?

Cada resposta reporta os créditos gastos e o histórico fica legível em /api/v1/generations. Os preços são por motor e definidos no espaço de trabalho, nunca no pedido.

Um agente pode servir muitos prompts?

É para isso que servem as variáveis: o agente guarda o modelo e o estilo, e a chamada preenche o que muda. Um catálogo de produtos é um agente e N chamadas, não N agentes.

As imagens também chegam por webhook?

O generation.completed dispara para imagens tal como para vídeo e áudio, por isso uma única subscrição cobre toda a família das gerações.

Posso usar uma imagem gerada num vídeo?

Sim. O URL gerado entra diretamente numa camada da timeline, e o renders.create transforma toda a composição num mp4 com a mesma chave.

Especificação OpenAPI Códigos de erro Explorar a API

Pronto para criar?

Comece a gerar vídeos virais em minutos. Não é necessário cartão de crédito para o teste gratuito.

Começar Grátis

ouVer demos

Pagamentos seguros

Acesso instantâneo

Cancele quando quiser

Gere imagense termine-as na mesma cadeia de chamadas