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 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
{
"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
{
"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
{
"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-01prompt(string, obrigatório), ex.:A clean editorial illustration of a paper airplane.aspect_ratio(string, opcional, padrão "1:1"), ex.:1:1response_format(string, opcional, padrão "url"), ex.:urln(integer, opcional, padrão 1, mín. 1, máx. 9), ex.:1
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.
model(string, obrigatório), ex.:gpt-image-2prompt(string, obrigatório), ex.:A clean editorial illustration of a paper airplane.size(string, opcional, padrão "1024x1024"), ex.:1024x1024quality(string, opcional, padrão "medium"), ex.:mediumn(integer, opcional, padrão 1, mín. 1, máx. 4), ex.:1
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
- Calendário de conteúdo a partir de tendências públicas
- Vídeo curto estilo UGC a partir de um briefing
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.