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": "gpt-image-1-official",
    "prompt": "An ancient castle under a starry sky",
    "size": "1:1",
    "quality": "auto",
    "n": 1
  }'

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

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": "gpt-image-1-official",
    "prompt": "An ancient castle under a starry sky",
    "size": "1:1",
    "quality": "auto",
    "n": 1
  }'

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

​
Modelos suportados

ModeloDescriçãoModosGeração a partir de imagemMáx. de imagensCobrança
gpt-image-1-officialEstabilidade prioritária, adequado para geração de imagens em geralTexto para imagem / Imagem para imagemSuportado4Size x Quality
gpt-image-1.5-officialNova versão, adequada para maior qualidade e edição complexaTexto para imagem / Imagem para imagemSuportado4Size x Quality

​
Autorizações

​
Authorization
string
obrigatório
Todas as requisições à API requerem autenticação por Bearer TokenObtenha sua chave de API:Acesse a página de gerenciamento de chaves de API para obter sua chave de APIAdicione o seguinte aos cabeçalhos da sua requisição:
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
obrigatório
Nome do modelo
  • gpt-image-1-official - Estabilidade prioritária, adequado para geração de imagens em geral
  • gpt-image-1.5-official - Nova versão, adequada para maior qualidade e edição complexa
​
prompt
string
obrigatório
Descrição textual para geração da imagem, suporta tanto chinês quanto inglês
​
size
string
padrão:"1:1"
Proporção da imagemProporções suportadas:
  • 1:1 - Quadrado (padrão)
  • 3:2 - Paisagem
  • 2:3 - Retrato
​
n
integer
padrão:"1"
Número de imagens a serem geradasIntervalo: 1-4
  • Valores ≤ 0 serão tratados como 1
  • Valores > 4 serão tratados como 4
Aviso: Deve ser um número puro (ex.: 1), não use aspas, caso contrário ocorrerá um erro
​
quality
string
padrão:"auto"
Qualidade da imagem
  • auto - Seleção automática de qualidade (padrão)
  • low - Mais rápido, mais econômico
  • medium - Equilíbrio entre qualidade e custo
  • high - Qualidade mais alta, custo mais alto
​
background
string
padrão:"auto"
Modo de fundo
  • auto - Fundo automático (padrão)
  • opaque - Fundo opaco
  • transparent - Fundo transparente, recomendado com o formato de saída png
background: transparent não pode ser usado simultaneamente com output_format: jpeg
​
moderation
string
padrão:"auto"
Nível de moderação
  • auto - Nível de moderação padrão
  • low - Moderação mais permissiva
​
output_format
string
padrão:"png"
Formato de saída
  • png - Formato padrão, adequado para fundos transparentes
  • jpeg - Tamanho de arquivo menor, adequado para saída de imagens em geral
background: transparent não pode ser usado simultaneamente com output_format: jpeg
​
output_compression
integer
Nível de compressão de saída, intervalo 0-100
  • Recomendado apenas para jpeg
  • Não recomendado para png
​
image_urls
array
Array de URLs de imagens de referência, ativa o modo imagem para imagem quando fornecidoLimite: Até 15 imagens de referência
​
mask_url
string
URL da imagem de máscara para inpainting
  • Deve ser usado em conjunto com image_urls
  • Será submetida via a API oficial de edição
  1. Antes de fazer o upload da imagem de máscara, confirme que o canal Alpha da imagem está como “Sim”.
  2. O tamanho da imagem de máscara deve coincidir com a primeira imagem de referência.

​
Referência de tamanhos

As proporções são usadas externamente; o sistema as mapeia automaticamente para as dimensões oficiais internamente.
ProporçãoTamanho realDescrição
1:11024x1024Quadrado
2:31024x1536Retrato
3:21536x1024Paisagem

​
Exemplos de uso

Texto para imagem (mínimo) 
{
  "model": "gpt-image-1-official",
  "prompt": "An ancient castle under a starry sky"
}
Texto para imagem (parâmetros completos) 
{
  "model": "gpt-image-1-official",
  "prompt": "A flat icon of a glass bottle with no background",
  "size": "2:3",
  "quality": "high",
  "background": "transparent",
  "moderation": "low",
  "output_format": "png",
  "n": 1
}
Imagem para imagem (referência única) 
{
  "model": "gpt-image-1.5-official",
  "prompt": "Convert the reference image to illustration style, preserving the main outline",
  "size": "1:1",
  "quality": "auto",
  "image_urls": [
    "https://your-cdn.com/input.png"
  ],
  "n": 1
}
Imagem para imagem (fusão de múltiplas referências) 
{
  "model": "gpt-image-1.5-official",
  "prompt": "Merge two reference images into an illustration poster, preserving the main outlines",
  "size": "1:1",
  "quality": "auto",
  "background": "transparent",
  "image_urls": [
    "https://your-cdn.com/input-a.png",
    "https://your-cdn.com/input-b.png"
  ],
  "moderation": "low",
  "output_format": "png",
  "n": 1
}
Múltiplas imagens (n > 1) 
{
  "model": "gpt-image-1-official",
  "prompt": "Four minimalist poster variations of a red fox",
  "size": "1:1",
  "quality": "low",
  "output_format": "png",
  "n": 4
}

​
Response

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

​
Observações

  1. Processamento assíncrono: Após o envio, um task_id é retornado. Faça polling em /v1/tasks/{task_id} para obter os resultados
  2. Escolha do modelo: Use gpt-image-1-official para geração de imagens em geral; use gpt-image-1.5-official para edição de alta qualidade e tarefas complexas de imagem para imagem
  3. Requisitos da URL da imagem: Para imagem para imagem, use URLs de imagens publicamente acessíveis e estáveis
  4. Cobrança: Cobrado por imagem gerada com sucesso; sem cobrança em caso de falha