Saltar para o conteúdo principal
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "A bamboo forest path under moonlight",
    "size": "1:1",
    "n": 1,
    "resolution": "1K"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "A bamboo forest path under moonlight",
    "size": "1:1",
    "n": 1,
    "resolution": "1K"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

​
Autorizações

​
Authorization
string
obrigatório
Todas as APIs requerem autenticação por Bearer TokenObter chave de API:Acesse a página de gerenciamento de chaves de API para obter sua chave de APIAdicione ao cabeçalho da requisição:
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
padrão:"gemini-3-pro-image-preview"
obrigatório
Nome do modelo de geração de imagensModelos suportados:
  • gemini-3-pro-image-preview - Versão padrão
  • gemini-3-pro-image-preview-official - Versão oficial
Exemplo: "gemini-3-pro-image-preview" ou "gemini-3-pro-image-preview-official"
​
prompt
string
obrigatório
Descrição textual para a geração da imagem
​
size
string
Tamanho da imagem geradaFormatos suportados:
  • Proporções: auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
Para geração a partir de texto, quando size é auto, o padrão é 1:1 ou 16:9; para geração a partir de imagem, a proporção segue a resposta do upstream. Recomendamos especificar uma proporção explicitamente.
​
n
integer
Número de imagens a serem geradasIntervalo: 1-4 (mínimo 1, máximo 4)Padrão: 1⚠️ Observação: Deve ser um número puro (ex.: 1), não use aspas, caso contrário ocorrerá um erro
​
resolution
string
Resolução da imagem de saídaValores suportados:
  • 1K - Resolução 1K (padrão)
  • 2K - Resolução 2K
  • 4K - Resolução 4K
⚠️ Observação: Gerar imagens em 4K no formato base64 leva um tempo de processamento maior
​
official_fallback
boolean
padrão:"false"
Se deve usar o fallback do canal oficial
  • false: Não usar (padrão)
  • true: Usar o canal oficial
Ao usar o canal oficial (gemini-3-pro-image-preview-official), este parâmetro não pode ser utilizado.
​
image_urls
array
Lista de URLs de imagens de referência para geração a partir de imagem ou edição de imagem💡 Preenchimento rápido (área “Try it”):
  1. Clique em ”+ Add an item” para adicionar uma URL de imagem
  2. Insira o endereço de URL completo da imagem ou os dados em base64
Limite: Máximo de 14 imagens

​
Response

​
code
integer
Código de status da resposta
​
data
array
Array de dados da resposta