---
title: "Início rápido"
description: "Da chave ao arquivo gerado em quatro passos."
source_url: "https://hypio.doti.gg/docs/inicio-rapido"
updated: "2026-11-11"
---

# Início rápido

Da chave ao arquivo gerado em quatro passos.

## 1. Crie uma chave

Em [Configurações → Chaves de API](https://hypio.doti.gg/configuracoes/api-keys), crie uma chave com os escopos `read` e `write`. Ela começa com `dsk_` e aparece uma vez só. Precisa do papel de administrador ou dono da organização.

## 2. Guarde no ambiente

```bash
export HYPIO_API_KEY="dsk_..."
```

> Nunca coloque a chave no código nem no navegador. Quem tem a chave gasta o saldo da organização.

## 3. Gere e espere

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"])
```

## 4. Baixe o arquivo

Quando o `status` for `succeeded`, cada item de `outputs` tem uma `url`. O download também pede a chave.

```bash
curl -L "https://hypio.doti.gg/api/v1/generations/<id>/outputs/0" \
  -H "Authorization: Bearer $HYPIO_API_KEY" \
  -o resultado
```