Geração de imagens por IA

Geração de imagens por IA: Crie imagens a partir de texto com modelos de ponta.

Atualizado em .

O que é Geração de imagens por IA na APIcultura

Acesse Geração de imagens por IA pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Crie imagens a partir de texto com modelos de ponta. Respostas em JSON, cobrança só por chamada concluída e estorno automático em falhas.

Categoria: Geração de mídia. Autenticação: chave da própria APIcultura (apk_live_...); nenhuma conta de terceiros precisa ser conectada.

Endpoints e preço por chamada

Endpoint (slug)O que fazPreço por chamadaRota
imagem-gemini-economicaImagem (Gemini, econômica)R$ 0,36POST /v1/call/imagem-gemini-economica
imagem-gemini-rapidaImagem (Gemini, rápida)R$ 1,48POST /v1/call/imagem-gemini-rapida
imagem-gemini-proImagem (Gemini Pro)R$ 2,33POST /v1/call/imagem-gemini-pro
imagem-minimaxImagem (MiniMax)R$ 0,29POST /v1/call/imagem-minimax
imagem-gptImagem (GPT Image)R$ 1,52POST /v1/call/imagem-gpt

Imagem (Gemini, econômica) (imagem-gemini-economica)

Gera uma imagem a partir de um texto, versão econômica. Preço: R$ 0,36 por chamada.

Schema de entrada de imagem-gemini-economica

{
  "required": [
    "contents",
    "generationConfig"
  ],
  "properties": {
    "contents": {
      "type": "array"
    },
    "generationConfig": {
      "type": "object"
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Imagem (Gemini, rápida) (imagem-gemini-rapida)

Gera uma imagem a partir de um texto. Preço: R$ 1,48 por chamada.

Schema de entrada de imagem-gemini-rapida

{
  "required": [
    "contents",
    "generationConfig"
  ],
  "properties": {
    "contents": {
      "type": "array"
    },
    "generationConfig": {
      "type": "object"
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Imagem (Gemini Pro) (imagem-gemini-pro)

Gera imagens de alta qualidade e texto legível. Preço: R$ 2,33 por chamada.

Schema de entrada de imagem-gemini-pro

{
  "required": [
    "contents",
    "generationConfig"
  ],
  "properties": {
    "contents": {
      "type": "array"
    },
    "generationConfig": {
      "type": "object"
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Imagem (MiniMax) (imagem-minimax)

Gera uma imagem a partir de um texto. Preço: R$ 0,29 por chamada.

Schema de entrada de imagem-minimax

{
  "required": [
    "model",
    "prompt"
  ],
  "properties": {
    "model": {
      "type": "string",
      "maxLength": 2000
    },
    "prompt": {
      "type": "string",
      "maxLength": 2000
    },
    "aspect_ratio": {
      "type": "string",
      "maxLength": 2000
    },
    "response_format": {
      "type": "string",
      "maxLength": 2000
    },
    "n": {
      "type": "number"
    }
  }
}

Imagem (GPT Image) (imagem-gpt)

Gera uma imagem com o GPT Image. Preço: R$ 1,52 por chamada.

Schema de entrada de imagem-gpt

{
  "required": [
    "model",
    "prompt"
  ],
  "properties": {
    "model": {
      "type": "string",
      "maxLength": 2000
    },
    "prompt": {
      "type": "string",
      "maxLength": 2000
    },
    "size": {
      "type": "string",
      "maxLength": 2000
    },
    "quality": {
      "type": "string",
      "maxLength": 2000
    },
    "n": {
      "type": "number"
    }
  }
}

Exemplo de chamada MCP

Com o MCP da APIcultura conectado, o agente usa a ferramenta call com o slug do endpoint e a entrada:

{ "name": "call", "arguments": { "slug": "imagem-gemini-economica", "input": {"contents":[{"parts":[{"text":"A clean editorial illustration of a paper airplane."}]}],"generationConfig":{},"fields":"candidates(content(parts(text,inlineData)),finishReason),usageMetadata,modelVersion,responseId,promptFeedback"}, "max_cost_brl": 0.1 } }

Exemplo de chamada HTTP

curl -X POST https://api.apicultura.app/v1/call/imagem-gemini-economica \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"A clean editorial illustration of a paper airplane."}]}],"generationConfig":{},"fields":"candidates(content(parts(text,inlineData)),finishReason),usageMetadata,modelVersion,responseId,promptFeedback"}'

Formato da resposta, preço e limites

A resposta é JSON com data (o resultado do endpoint) e meta (inclui cost_brl, o valor cobrado). Preço deste endpoint: R$ 0,36 por chamada. Falhas do serviço (502) e pedidos recusados (422) não são cobrados. Use max_cost_brl para limitar o gasto por chamada; o saldo pré-pago em R$ é o teto. Parâmetros de entrada: exemplo acima.

Workflows que usam Geração de imagens por IA

Experimente

Teste no playground interativo: Geração de imagens por IA no playground. Veja também todas as ferramentas, como conectar seu agente e o FAQ.

Nota. Geração de imagens por IA é marca de seus respectivos donos, citada apenas para identificar a integração.