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": "wan2.7-image-pro",
    "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
  }'

{
  "code": "success",
  "data": [
    {
      "task_id": "task_01HX...",
      "status": "processing"
    }
  ]
}

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": "wan2.7-image-pro",
    "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
  }'

{
  "code": "success",
  "data": [
    {
      "task_id": "task_01HX...",
      "status": "processing"
    }
  ]
}

​
Autorização

​
Authorization
string
obrigatório
Todas as requisições exigem autenticação por Bearer Token.Acesse a página de gerenciamento de chaves de API para obter sua chave de API e, em seguida, adicione-a ao cabeçalho da requisição:
Authorization: Bearer YOUR_API_KEY

​
Modelos disponíveis

ModeloDescriçãoResolução máxima (Text-to-Image)Resolução máxima (Edição / Sequencial)Preço
wan2.7-image-proEdição profissional, melhores detalhes, suporta 4K4K2K¥0,50 / imagem
wan2.7-imageEdição padrão, geração mais rápida2K2K¥0,20 / imagem
A cobrança é feita com base em imagens geradas com sucesso × preço unitário. A entrada não é cobrada. Resolução e proporção não afetam o preço. Requisições com falha não são cobradas.

​
Corpo da requisição

​
model
string
obrigatório
Nome do modelo de geração de imagens.
  • wan2.7-image-pro — Edição profissional, até 4K para text-to-image
  • wan2.7-image — Edição padrão, mais rápida, até 2K
​
prompt
string
Descrição textual para a geração da imagem, até 5000 caracteres.
  • Text-to-image (sem image_urls): obrigatório
  • Edição de imagens (com image_urls): opcional, mas recomendado
Exemplo: "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
​
image_urls
array<string>
Array de URLs de imagens de entrada para cenários de edição e referência multi-imagem.Fornecer esse campo altera a requisição para o modo de edição de imagens.Formatos suportados: URLs HTTP/HTTPS; Base64 data:image/...;base64,...Restrições: até 9 imagens; JPEG / PNG / WEBP / BMP; 240–8000 px, proporção 1:8 ~ 8:1; ≤ 20MB por imagem
A proporção de saída corresponde automaticamente à última imagem de entrada. O modo de edição suporta no máximo 2K — 4K não está disponível.
​
n
integer
padrão:"1"
Número de imagens a serem geradas.
  • Modo padrão: 1–4 (padrão 1)
  • Modo sequencial (enable_sequential: true): 1–12 (padrão 1)
Cobrado por imagem gerada com sucesso. Cobrança antecipada com base em n.
​
size
string
Resolução ou proporção de saída. Suporta três formatos:① Palavra-chave de resolução (recomendado): 1K / 2K (padrão) / 4K (somente text-to-image com wan2.7-image-pro)② Proporção: 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 (padrão para o nível 2K)③ Dimensões em pixels: 1024x1024 ou 1024*1024
​
resolution
string
Palavra-chave do nível de resolução: 1K / 2K / 4K. Pode ser combinado com size (proporção).
ModeloCenárioNíveis suportadosFaixa de pixels
wan2.7-image-proText-to-image (não sequencial)1K / 2K / 4K768×768 ~ 4096×4096
wan2.7-image-proEdição / sequencial1K / 2K768×768 ~ 2048×2048
wan2.7-imageTodos os cenários1K / 2K768×768 ~ 2048×2048
​
negative_prompt
string
Prompt negativo descrevendo elementos a evitar. Exemplo: "blurry, distorted, low quality"
​
watermark
boolean
padrão:"false"
Define se uma marca d’água “AI Generated” deve ser adicionada no canto inferior direito.
​
seed
integer
Semente aleatória, intervalo 0–2147483647. A mesma semente com parâmetros idênticos produz resultados visualmente consistentes.
​
thinking_mode
boolean
padrão:"true"
Ativa o modo de raciocínio aprimorado para melhorar a qualidade da imagem ao custo de um tempo de geração mais longo.
Só tem efeito quando o modo sequencial está desativado e nenhuma imagem de entrada é fornecida.
​
enable_sequential
boolean
padrão:"false"
Ativa o modo de geração sequencial de imagens — gera múltiplas imagens tematicamente coerentes em uma única requisição. Ideal para storyboards e séries.
  • Quando ativado, o n máximo é 12
  • thinking_mode e color_palette são ignorados no modo sequencial
  • O wan2.7-image-pro suporta até 2K no modo sequencial (4K não é suportado)
​
bbox_list
array
Caixas delimitadoras (bounding boxes) para edição interativa — especifica regiões exatas para editar ou inserir conteúdo.Estrutura: [[[x1, y1, x2, y2], ...], ...]
  • O comprimento do array externo deve ser igual ao comprimento de image_urls
  • Passe [] para imagens sem caixa delimitadora
  • Máximo de 2 caixas por imagem; as coordenadas são valores absolutos em pixels, com origem (0,0) no canto superior esquerdo
Exemplo: [[], [[989, 515, 1138, 681]]]
​
color_palette
array<object>
Tema de cores personalizado. Somente no modo padrão (não no modo sequencial).
  • 3–10 entradas (8 recomendadas); cada entrada exige hex e ratio
  • A soma de todos os valores de ratio deve ser exatamente 100.00%
[
  { "hex": "#C2D1E6", "ratio": "23.51%" },
  { "hex": "#636574", "ratio": "76.49%" }
]

​
Resposta

​
code
string
Status da resposta. Retorna "success" em caso de sucesso.
​
data
array

​
Exemplos

​
Texto para imagem (mínimo)

{
  "model": "wan2.7-image-pro",
  "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
}

​
Texto para imagem (com resolução)

{
  "model": "wan2.7-image-pro",
  "prompt": "Summer beach, blue sky and white clouds, 4K ultra HD",
  "size": "4K",
  "thinking_mode": true
}

​
Texto para imagem (paleta de cores personalizada)

{
  "model": "wan2.7-image-pro",
  "prompt": "Minimalist modern living room",
  "size": "2K",
  "color_palette": [
    { "hex": "#C2D1E6", "ratio": "23.51%" },
    { "hex": "#CDD8E9", "ratio": "20.13%" },
    { "hex": "#B5C8DB", "ratio": "15.88%" },
    { "hex": "#C0B5B4", "ratio": "13.27%" },
    { "hex": "#DAE0EC", "ratio": "10.11%" },
    { "hex": "#636574", "ratio": "8.93%" },
    { "hex": "#CACAD2", "ratio": "5.55%" },
    { "hex": "#CBD4E4", "ratio": "2.62%" }
  ]
}

​
Geração sequencial de imagens

{
  "model": "wan2.7-image-pro",
  "prompt": "Cinematic series: the same stray orange cat, consistent features. First: under cherry blossoms in spring. Second: old street shade in summer. Third: fallen leaves in autumn. Fourth: snow footprints in winter.",
  "enable_sequential": true,
  "n": 4,
  "size": "2K"
}

​
Edição de imagem única

{
  "model": "wan2.7-image",
  "prompt": "Replace the background with a sunset scene, warm color tones",
  "image_urls": ["https://example.com/portrait.jpg"],
  "size": "2K"
}

​
Referência multi-imagem / Fusão de elementos

{
  "model": "wan2.7-image-pro",
  "prompt": "Apply the graffiti from image 2 onto the car in image 1",
  "image_urls": [
    "https://example.com/car.webp",
    "https://example.com/paint.webp"
  ],
  "size": "2K"
}

​
Edição interativa (Bounding Box)

bbox_list corresponde a image_urls na proporção 1 para 1. Passe [] para imagens sem seleção. 
{
  "model": "wan2.7-image-pro",
  "prompt": "Place the alarm clock from image 1 into the selected area of image 2, blending naturally",
  "image_urls": [
    "https://example.com/clock.webp",
    "https://example.com/desk.webp"
  ],
  "bbox_list": [
    [],
    [[989, 515, 1138, 681]]
  ],
  "size": "2K"
}
Consulta de resultadosA geração de imagens é assíncrona. Consulte o endpoint Status da Tarefa usando o task_id retornado até que status == completed.