One request, best provider.

Routing: two ways to decide

1 — You are the router. Pull the live price table and force any provider per request with the provider field. Your logic, our execution.

2 — ElliSekiz decides. Omit provider and the router follows your account policy: cheapest-first by default, or your saved provider priority list. If you stored your own provider key (BYOK), it is preferred and billed to your upstream account — currently with no platform fee.

1. Get the price table

curl https://ellisekiz.ai/api/v1/models

Returns every model with per-provider offers and USD prices, billed 1:1 at provider cost. Multi-provider models are marked multi_provider: true.

2. Submit a generation

curl -X POST https://ellisekiz.ai/api/v1/generations \
  -H "Authorization: Bearer esk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-schnell",
    "prompt": "a lighthouse at dawn, oil painting"
  }'

Response is 202 with a generation id. Add "provider": "fal" (or replicate, atlascloud) to pin the provider yourself.

3. Poll until done

curl https://ellisekiz.ai/api/v1/generations/GEN_ID \
  -H "Authorization: Bearer esk_..."

{
  "id": "GEN_ID",
  "status": "completed",
  "provider": "fal",
  "usd": 0.003,
  "output": "https://.../image.jpg"
}

Poll every 2–3 seconds. Credits are charged only when a generation completes; failures are free.

Billing model

• Platform keys: the provider's own price per generation, deducted 1:1 from your prepaid USD balance.
• Your own provider keys (BYOK): upstream usage bills your provider account directly — currently no platform fee.