Documentos UlazAI

Imagem e vídeo APIs

Imagem API

Preços Painel Estúdio de imagem

POSTAR /api/v1/generate/

Endpoint de geração de imagem canônica

Use este endpoint para todas as novas integrações. Escolha um modelo com model e opcionalmente passar image_urls para editar fluxos de trabalho em modelos suportados.

Status da pesquisa com /api/v1/generate/{generation_id}/ e usar /api/v1/generate/history/ para histórico de trabalho.

Solicitar contrato

Campo	Tipo	Obrigatório	Notas
`prompt`	corda	Sim	1 a 5.000 caracteres
`model`	corda	Não	O padrão é `gpt_image_15`
`size`	corda	Não	Os valores permitidos dependem do modelo selecionado. `gpt_image_2` também aceita proporções personalizadas como `5:7` ou `1024x768`.
`quality`	corda	Não	Modo de resolução ou qualidade, específico do modelo
`image_urls`	matriz[string]	Não*	Usado para editar fluxos de trabalho em modelos como `gpt_image_2`, `qwen_image`e `wan_2_7_image`. Obrigatório para `ideogram_character`.

Seletor de modelo

Alterne as predefinições de modelo para atualizar exemplos de solicitação instantaneamente.

Seedream 5.0 Lite model=seedream_5_lite

Multimodal reasoning model with text-to-image and image editing.

Tamanhos permitidos: 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9

Valores de qualidade permitidos: basic, high

Modo de edição: suportado

Snippets de solicitação em tempo real

Os trechos abaixo seguem a predefinição do modelo selecionado.

curvatura

JavaScript (buscar)

Python (solicitações)

Exemplos de resposta

201 Criado

{
  "success": true,
  "data": {
    "generation_id": "5a6be42f-4f01-4e80-9e16-8105315f0e62",
    "status": "processing",
    "estimated_time": "varies by model and queue",
    "credits_used": 8,
    "credits_remaining": 124,
    "message": "Generation started successfully"
  }
}

402 Pagamento necessário

{
  "success": false,
  "error": "Insufficient credits. Need 18, have 7",
  "credits_needed": 18,
  "credits_balance": 7
}

400 Solicitação incorreta

{
  "success": false,
  "error": "Invalid size. Must be one of: 1:1, 3:2, 2:3"
}