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": "doubao-seedance-4-0",
    "prompt": "A cute panda playing in a bamboo forest",
    "size": "1:1",
    "resolution": "2K",
    "n": 1,
    "image_urls": [
      "https://cdn.apimart.ai/doc/1761215838466614297_9852.png"
    ]
  }'

{
  "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": "doubao-seedance-4-0",
    "prompt": "A cute panda playing in a bamboo forest",
    "size": "1:1",
    "resolution": "2K",
    "n": 1,
    "image_urls": [
      "https://cdn.apimart.ai/doc/1761215838466614297_9852.png"
    ]
  }'

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

​
Autorização

​
Authorization
string
obrigatório
Todos os endpoints da API exigem 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-a ao cabeçalho da requisição:
Authorization: Bearer YOUR_API_KEY

​
Corpo da requisição

​
model
string
padrão:"doubao-seedance-4-0"
obrigatório
Nome do modelo de geração de imagensModelos suportados: doubao-seedance-4-0, doubao-seedream-4.0, doubao-seedream-4-0, Doubao-Seedream-4.0Exemplo: "doubao-seedance-4-0"
​
prompt
string
obrigatório
Descrição textual para a geração da imagemMáximo de 1000 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
  • 21:9 - Ultra-wide
  • 9:21 - Ultra-tall
  • auto - Ajusta automaticamente a proporção pela imagem de referência (requer image_urls)
​
resolution
string
padrão:"2K"
Resolução da imagemResoluções suportadas:
  • 1K - Resolução básica
  • 2K - Resolução padrão (padrão)
  • 4K - Alta definição
Tamanhos de referência para as resoluções:
ResoluçãoTamanho 1:1Tamanho 16:9
1K1024x10241280x720
2K2048x20482560x1440
4K4096x40965404x3040
​
n
integer
Número de imagens a serem geradasIntervalo: 1–15 (mínimo 1, máximo 15)Padrão: 1Observação:
  • O número efetivo de imagens geradas depende tanto desse parâmetro quanto da quantidade de imagens de referência enviadas. O total de imagens de referência + imagens geradas deve ser ≤ 15
  • É necessário informar um número puro (ex.: 1), não use aspas, caso contrário ocorrerá um erro
A cobrança será deduzida antecipadamente com base na quantidade
​
image_urls
array
Lista de URLs de imagens de referência para image-to-image ou edição de imagensDois formatos são suportados:1. URL completa da imagem
  • URL de imagem publicamente acessível (http:// ou https://)
  • Exemplo: https://example.com/image.jpg
2. Formato codificado em Base64
  • É obrigatório usar o formato Data URI completo
  • Formato: data:image/{format};base64,{base64-data}
  • Formatos de imagem suportados: jpeg, png
  • Exemplo: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • Atenção: o prefixo data:image/jpeg;base64, é obrigatório
Limites:
  • Máximo de 10 imagens
  • Formatos de imagem: jpeg, png
  • Intervalo de proporção (largura/altura): [1/3, 3]
  • Largura e altura (px) > 14
  • Tamanho: não exceder 10MB
  • Total de pixels: não exceder 6000×6000 px
​
optimize_prompt_options
string
padrão:"standard"
Modo de otimização de prompt
  • standard: modo padrão, gera conteúdo de maior qualidade com tempo de processamento mais longo
  • fast: modo rápido, gera conteúdo em menos tempo com qualidade comum
Padrão: standard
​
sequential_image_generation
string
padrão:"disabled"
Modo de geração sequencial de imagens (recurso específico da Doubao)Controla se múltiplas imagens devem ser geradas:
  • disabled: desativa o modo sequencial, gera apenas 1 imagem mesmo com múltiplas referências (padrão)
  • auto: ativa o modo sequencial, permite gerar múltiplas imagens
Notas de uso:
  • É obrigatório informar image_urls — pelo menos 1 imagem de referência é necessária
  • Defina n: 3 ou use sequential_image_generation: "auto" + max_images: 3
  • Isso gerará 3 imagens diferentes com base nas referências
  • Quando n > 1, o modo será automaticamente definido como auto
Limitações:
  • Text-to-image puro (sem image_urls) não pode gerar múltiplas imagens — essa é uma limitação da API Doubao
​
sequential_image_generation_options
object
Opções de geração sequencial de imagensDisponível quando sequential_image_generation está definido como autoPropriedades:
  • max_images (integer): define o número de imagens a serem geradas, intervalo: 1–15
Exemplo:
"sequential_image_generation": "auto",
"sequential_image_generation_options": {
  "max_images": 3
}
​
watermark
boolean
padrão:"false"
Define se uma marca d’água deve ser adicionada à imagem gerada
  • true: adicionar marca d’água
  • false: sem marca d’água (padrão)

​
Resposta

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