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": "qwen-image-2.0",
    "prompt": "A cute orange cat napping in the sunshine"
  }'

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

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": "qwen-image-2.0",
    "prompt": "A cute orange cat napping in the sunshine"
  }'

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

​
Modelos suportados

ModeloDescriçãoMáx. de imagensPreço
qwen-image-2.0Versão padrão, qualidade e desempenho equilibrados6Preço fixo
qwen-image-2.0-proVersão Pro, renderização de texto mais forte, texturas realistas mais refinadas6Preço fixo

​
Autorização

​
Authorization
string
obrigatório
Todos os endpoints exigem autenticação por Bearer TokenObtenha sua chave de API:Acesse o gerenciamento de chaves de API para obter sua chave de APIAdicione-a ao cabeçalho da requisição:
Authorization: Bearer YOUR_API_KEY

​
Corpo da requisição

​
model
string
obrigatório
Nome do modelo
  • qwen-image-2.0 - Versão padrão, qualidade e desempenho equilibrados
  • qwen-image-2.0-pro - Versão Pro, renderização de texto mais forte, texturas realistas mais refinadas
​
prompt
string
obrigatório
Descrição textual para a geração da imagem, até 800 caracteres
​
size
string
padrão:"1:1"
Proporção da imagemProporções suportadas:
  • 1:1 - Quadrado (padrão)
  • 4:3 - Paisagem 4:3
  • 3:4 - Retrato 3:4
  • 16:9 - Paisagem widescreen
  • 9:16 - Retrato vertical
  • 3:2 - Paisagem 3:2
  • 2:3 - Retrato 2:3
​
resolution
string
padrão:"1K"
Nível de resolução
  • 1K - Resolução padrão (padrão)
  • 2K - Resolução de alta definição
​
n
integer
padrão:"1"
Número de imagens a serem geradasIntervalo: 1–6
​
negative_prompt
string
Prompt negativo (conteúdo que você não quer que apareça), até 500 caracteres
​
image_urls
array
Array de URLs de imagens de referência (modo image-to-image)Limitações:
  • Devem ser URLs publicamente acessíveis
  • O formato Base64 não é suportado

​
Tabela de referência de resoluções

O tamanho da saída é controlado pela combinação size (proporção) + resolution (nível de resolução).
ProporçãoNível 1KNível 2K
1:11024×10242048×2048
4:31152×8642048×1536
3:4864×11521536×2048
16:91280×7202048×1152
9:16720×12801152×2048
3:21248×8322048×1360
2:3832×12481360×2048
  • Apenas size → padrão para o nível 1K: {"size": "16:9"} → 1280×720
  • size + resolution → nível especificado: {"size": "16:9", "resolution": "2K"} → 2048×1152

​
Exemplos de uso

Text-to-Image (requisição mínima) 
{
  "model": "qwen-image-2.0",
  "prompt": "A cute orange cat napping in the sunshine"
}
Especificar proporção e quantidade 
{
  "model": "qwen-image-2.0-pro",
  "prompt": "Cyberpunk-style futuristic city nightscape with flickering neon lights",
  "size": "16:9",
  "n": 4
}
Nível 2K de alta definição 
{
  "model": "qwen-image-2.0-pro",
  "prompt": "Exquisite food photography, sushi platter",
  "size": "4:3",
  "resolution": "2K",
  "n": 2
}
Image-to-Image (imagem de referência + descrição textual) 
{
  "model": "qwen-image-2.0",
  "prompt": "Change the background to a seaside sunset",
  "image_urls": ["https://example.com/my-photo.jpg"]
}

​
Resposta

​
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. Consulte /v1/tasks/{task_id} para obter os resultados
  2. Armazenamento de imagens: as imagens geradas são espelhadas no CDN da plataforma e ficam válidas por longo prazo
  3. Regras de cobrança: cobrado por imagem gerada com sucesso, sem cobrança em caso de falha
  4. Requisitos para URLs de imagens: as imagens de entrada devem ser URLs publicamente acessíveis; base64 não é suportado