# Geração de imagens por IA

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

URL: https://apicultura.app/ferramentas/imagem-ia/
Atualizado em 05/11/2026 (2026-11-05).

## 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](/catalogo/?cat=midia). 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 faz | Preço por chamada | Rota |
|---|---|---|---|
| `imagem-gemini-economica` | Imagem (Gemini, econômica) | R$ 0,36 | `POST /v1/call/imagem-gemini-economica` |
| `imagem-gemini-rapida` | Imagem (Gemini, rápida) | R$ 1,48 | `POST /v1/call/imagem-gemini-rapida` |
| `imagem-gemini-pro` | Imagem (Gemini Pro) | R$ 2,33 | `POST /v1/call/imagem-gemini-pro` |
| `imagem-minimax` | Imagem (MiniMax) | R$ 0,29 | `POST /v1/call/imagem-minimax` |
| `imagem-gpt` | Imagem (GPT Image) | R$ 1,52 | `POST /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.

- `contents` (array, obrigatório), ex.: `[object Object]`
- `generationConfig` (object, obrigatório)

### Schema de entrada de imagem-gemini-economica

```json
{
  "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.

- `contents` (array, obrigatório), ex.: `[object Object]`
- `generationConfig` (object, obrigatório)

### Schema de entrada de imagem-gemini-rapida

```json
{
  "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.

- `contents` (array, obrigatório), ex.: `[object Object]`
- `generationConfig` (object, obrigatório)

### Schema de entrada de imagem-gemini-pro

```json
{
  "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.

- `model` (string, obrigatório), ex.: `image-01`
- `prompt` (string, obrigatório), ex.: `A clean editorial illustration of a paper airplane.`
- `aspect_ratio` (string, opcional, padrão "1:1"), ex.: `1:1`
- `response_format` (string, opcional, padrão "url"), ex.: `url`
- `n` (integer, opcional, padrão 1, mín. 1, máx. 9), ex.: `1`

### Schema de entrada de imagem-minimax

```json
{
  "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.

- `model` (string, obrigatório), ex.: `gpt-image-2`
- `prompt` (string, obrigatório), ex.: `A clean editorial illustration of a paper airplane.`
- `size` (string, opcional, padrão "1024x1024"), ex.: `1024x1024`
- `quality` (string, opcional, padrão "medium"), ex.: `medium`
- `n` (integer, opcional, padrão 1, mín. 1, máx. 4), ex.: `1`

### Schema de entrada de imagem-gpt

```json
{
  "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:

```json
{ "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

```bash
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

- [Calendário de conteúdo a partir de tendências públicas](/workflows/calendario-conteudo/)
- [Vídeo curto estilo UGC a partir de um briefing](/workflows/video-ugc/)

## Experimente

Teste no playground interativo: [Geração de imagens por IA no playground](/ferramentas/ferramenta.html?slug=imagem-ia). Veja também [todas as ferramentas](/ferramentas/), [como conectar seu agente](/como-conectar/) e o [FAQ](/faq/).

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