# API Z Image Referência completa da API para geração de texto para imagem Z Image. ## Variantes do modelo Esta API oferece suporte a uma variante do modelo: | Modelo | ID | Descrição | |-------|-----|-------------| | **Z Image** | `z-image` | Geração rápida de texto para imagem | ## Comparação rápida | Recurso | Z Image | |---------|---------| | Entrada | Prompt de texto | | Saída | Uma única imagem gerada | | Proporções | Várias proporções suportadas | | Resolução | Derivada dos valores de proporção width/height | | `seed` | Opcional | ### Proporções suportadas O par `width:height` deve ser um dos seguintes: `1:1`, `3:2`, `2:3`, `3:4`, `4:3`, `9:16`, `16:9`, `9:21` ## Z Image (texto para imagem) ### Ponto de acesso ``` POST /api/v1/image/task ``` ### Parâmetros da solicitação #### Obrigatórios | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `model_name` | string | Deve ser `"z-image"` | | `prompt` | string | Prompt de geração de imagem | | `width` | number | Valor da proporção de largura (por exemplo, `16` para `16:9`) | | `height` | number | Valor da proporção de altura (por exemplo, `9` para `16:9`) | #### Opcionais | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `seed` | number | Seed aleatória no intervalo `[0, 2147483647]`. Use `null` ou `0` para geração aleatória. | ### Exemplo de solicitação ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'z-image', prompt: 'A cinematic portrait of a traveler standing on a cliff at golden hour', width: 16, height: 9, seed: 0 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Formato da resposta Resposta de envio: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/image/{task_id}", "task_status": "submitted" } } ``` Consulte com `GET /api/v1/image/{task_id}`. Status da tarefa: `submitted`, `processing`, `succeed`, `failed`. Respostas de polling bem-sucedidas expõem URLs de imagens geradas em `data.task_result.images[].url`. ## Boas práticas - Use valores de proporção, não dimensões em pixels, para `width` e `height`. - Mantenha os prompts descritivos, mas focados em assunto, iluminação e composição. - Use um `seed` fixo quando quiser gerações reproduzíveis durante os testes.