---
title: "Imagem"
description: "Texto para imagem, de 1 a 4 imagens por pedido."
source_url: "https://hypio.doti.gg/docs/imagem"
updated: "2026-11-11"
---

# Imagem

Texto para imagem, de 1 a 4 imagens por pedido.

`kind: "image"`. O preço é por imagem, vezes `count`.

## Requisição

cURL:

```bash
curl -X POST https://hypio.doti.gg/api/v1/generations \
  -H "Authorization: Bearer $HYPIO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "kind": "image",
  "model": "seedream-5.0-flash",
  "prompt": "Uma xícara de café numa mesa de madeira, luz suave da manhã",
  "ratio": "1:1",
  "resolution": "1K"
}'

curl https://hypio.doti.gg/api/v1/generations/<id> \
  -H "Authorization: Bearer $HYPIO_API_KEY"
```

JavaScript:

```javascript
const API = "https://hypio.doti.gg/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.HYPIO_API_KEY}`,
  "Content-Type": "application/json",
};

let generation = await fetch(`${API}/generations`, {
  method: "POST",
  headers: { ...headers, "Idempotency-Key": crypto.randomUUID() },
  body: JSON.stringify({
    "kind": "image",
    "model": "seedream-5.0-flash",
    "prompt": "Uma xícara de café numa mesa de madeira, luz suave da manhã",
    "ratio": "1:1",
    "resolution": "1K"
  }),
}).then((res) => res.json());

while (generation.status === "queued" || generation.status === "running") {
  await new Promise((resolve) => setTimeout(resolve, 5000));
  generation = await fetch(`${API}/generations/${generation.id}`, { headers })
    .then((res) => res.json());
}

console.log(generation.status, generation.outputs);
```

Python:

```python
import os, time, uuid
import requests

API = "https://hypio.doti.gg/api/v1"
headers = {"Authorization": f"Bearer {os.environ['HYPIO_API_KEY']}"}

generation = requests.post(
    f"{API}/generations",
    headers={**headers, "Idempotency-Key": str(uuid.uuid4())},
    json={
      "kind": "image",
      "model": "seedream-5.0-flash",
      "prompt": "Uma xícara de café numa mesa de madeira, luz suave da manhã",
      "ratio": "1:1",
      "resolution": "1K"
    },
).json()

while generation["status"] in ("queued", "running"):
    time.sleep(5)
    generation = requests.get(f"{API}/generations/{generation['id']}", headers=headers).json()

print(generation["status"], generation["outputs"])
```

## Parâmetros

| Campo | Tipo | Regra |
| --- | --- | --- |
| `kind` | string | `"image"` |
| `model` | string | Um dos modelos abaixo. |
| `prompt` | string | Obrigatório. Até 2000 caracteres. |
| `ratio` | string | Proporção. Vazio usa o padrão do modelo. |
| `resolution` | string | Uma das resoluções do modelo. |
| `count` | inteiro | De 1 a 4. Padrão 1. |

## Modelos

| Modelo | `model` | A partir de |
| --- | --- | --- |
| Seedream 5.0 Pro | `seedream-5.0-pro` | R$ 0,41 |
| Seedream 4.5 | `seedream-4.5` | R$ 0,36 |
| Seedream 5.0 Flash | `seedream-5.0-flash` | R$ 0,17 |
| Wan 2.7 Pro | `wan-2.7-pro` | R$ 0,62 |

## Preços

O preço sai do mesmo catálogo que cobra a geração. Ele fica reservado no envio e é devolvido se a geração falhar.

| `model` | Resolução | Preço |
| --- | --- | --- |
| `seedream-5.0-pro` | `1K` | R$ 0,41 por imagem |
| `seedream-5.0-pro` | `2K` | R$ 0,81 por imagem |
| `seedream-4.5` | `2K` | R$ 0,36 por imagem |
| `seedream-5.0-flash` | `1K` | R$ 0,17 por imagem |
| `wan-2.7-pro` | `1K` | R$ 0,62 por imagem |
| `wan-2.7-pro` | `2K` | R$ 0,62 por imagem |