Começar

API do Hypio

Gere vídeo, imagem e voz pelo seu código. Uma chave, um endpoint de geração, e cada pedido vira uma geração que você consulta ou recebe por webhook.

Resumo

URL base	`https://staging-hypio.doti.gg/api/v1`
Autenticação	`Authorization: Bearer <chave>`
Chaves	Configurações → Chaves de API
Cobrança	Saldo pré-pago em reais. 1 crédito = R$ 0,01. Veja Créditos e cobrança.
Corpo	JSON na ida e na volta. Sucesso devolve o objeto; erro devolve `error`.

Faça uma chamada

Este pedido gera uma imagem com seedream-5.0-flash por R$ 0,17. A resposta chega na hora com a geração na fila; o arquivo fica pronto em segundos.

curl -X POST https://staging-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://staging-hypio.doti.gg/api/v1/generations/<id> \
  -H "Authorization: Bearer $HYPIO_API_KEY"

202 Accepted

{
  "id": "0b7c1e5a-4d2f-4c8e-9a51-6f3d2b8e7c10",
  "object": "generation",
  "kind": "image",
  "model": "seedream-5.0-flash",
  "status": "queued",
  "prompt": "Uma xícara de café numa mesa de madeira, luz suave da manhã",
  "ratio": "1:1",
  "resolution": "1K",
  "durationSeconds": null,
  "audio": null,
  "count": 1,
  "priceCredits": 17,
  "error": null,
  "outputs": [],
  "createdAt": "2026-11-11T14:02:11.000Z",
  "startedAt": null,
  "finishedAt": null
}

Como uma geração funciona

Envie. POST /v1/generations com kind, model e o prompt. A API confere o corpo, reserva o preço e responde 202 com o id.
Espere. Consulte GET /v1/generations/{id} até o status sair de queued e running, ou receba o evento por webhook.
Baixe. Cada item de outputs tem uma url da própria API. Geração que falha devolve a reserva.

Próximos passos

Início rápidoUma chave, uma imagem, o arquivo em quatro passos.AutenticaçãoCriar, enviar e restringir chaves.ModelosCada model, o que ele gera e quanto custa.VídeoTexto para vídeo, com ou sem som.ImagemTexto para imagem, de 1 a 4 por pedido.ÁudioTexto para voz, com a voz escolhida.GeraçõesEstados, consulta, idempotência e download.WebhooksEventos assinados quando a geração termina.