POST /v1/images/generations

Endpoint pra geração de imagem via Fal.ai (flux-schnell, sdxl). OpenAI compatible mas com parâmetros adicionais aceitos pelo Fal.

⚠Modelos Fal.ai exigem créditos na conta IT Booster Fal.ai. Se sua chamada retornar User locked: Exhausted balance, é o saldo Fal.ai que zerou (não o seu saldo Tokia). Reportar pra contato@usetokia.com.

Request body

Campo	Tipo	Obrigatório	Notas
`model`	string	sim	`fal_ai/fal-ai/flux/schnell` ou `fal_ai/fal-ai/fast-sdxl`
`prompt`	string	sim	Descrição da imagem em inglês ou português.
`n`	number	não	Quantidade de imagens (default 1, max 4).
`size`	string	não	`512x512`, `1024x1024`, etc.

Exemplo

bash

curl https://api.usetokia.com/v1/images/generations \
  -H "Authorization: Bearer $TOKIA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fal_ai/fal-ai/flux/schnell",
    "prompt": "a happy cat wearing a tiny brazilian flag bandana",
    "n": 1,
    "size": "512x512"
  }'

Response

json

{
  "created": 1778096405,
  "data": [
    { "url": "https://storage.fal.ai/files/abc123.png" }
  ],
  "usage": { "total_tokens": 0 }
}

URL da imagem é hospedada pelo Fal.ai (CDN). Persistir o arquivo é responsabilidade do cliente — Fal não garante retenção indefinida.