POST /v1/images/generations

Endpoint pra geração de imagem (flux-schnell, sdxl). OpenAI compatible com parâmetros adicionais.

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://cdn.usetokia.com/images/abc123.png" }
  ],
  "usage": { "total_tokens": 0 }
}

URL da imagem é hospedada em CDN. Persistir o arquivo é responsabilidade do cliente, não há garantia de retenção indefinida.