v1

API Reference

·fal.abhibots.com

How It Works

AbhiAPI is a transparent proxy for fal.ai. Every request goes directly to fal.ai — we handle auth and billing only. No lock-in, no proprietary format.

Just replace the base URL:

https://fal.run/fal-ai/flux/dev

https://fal.abhibots.com/fal-ai/flux/dev

Authentication

All requests require an x-api-key header with your AbhiAPI key.

http
x-api-key: sk-fal-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Keys start with sk-fal-. Get yours from the dashboard.

Quick Start

Image Generation

bash
curl -X POST https://fal.abhibots.com/fal-ai/flux/dev \
  -H "x-api-key: sk-fal-your-key" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a futuristic city at night", "image_size": "landscape_4_3"}'

Video Generation

bash
curl -X POST https://fal.abhibots.com/fal-ai/kling-video/v2/master/text-to-video \
  -H "x-api-key: sk-fal-your-key" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "drone shot over mountains", "duration": "5"}'

Upscaling

bash
curl -X POST https://fal.abhibots.com/fal-ai/creative-upscaler \
  -H "x-api-key: sk-fal-your-key" \
  -H "Content-Type: application/json" \
  -d '{"image_url": "https://example.com/photo.jpg", "scale": 4}'

Transparent Proxy

Any path on fal.ai works here. Request body is forwarded unchanged. See fal.ai/models for all model paths and parameters.

POST/{any-fal-path}

Proxied directly to fal.run/{any-fal-path} with your credentials

GET/fal-ai/queue/requests/{id}

Poll async job status

Response Format

A _billing object is appended to every fal.ai response. Everything else is untouched.

json
{
  // ... normal fal.ai response fields ...
  "images": [{ "url": "https://storage.googleapis.com/..." }],

  "_billing": {
    "model": "fal-ai/flux/dev",
    "credits_used": 12,
    "cost_usd": 0.012,
    "balance_remaining": 4988
  }
}

Billing & Pricing

Pay-as-you-go. No monthly fees. Prices mirror fal.ai with a small margin.

TypeModelsPrice
Image GenerationFlux, SDXL, etc.$0.003 – $0.05 / MP
Seedance Videoseedance-1 models$0.24 – $0.30 / sec
Veo Videoveo-2, veo-3$0.10 – $0.40 / sec
Sora Videosora-1$0.10 – $0.50 / sec
Kling Videokling-video v2$0.07 – $0.112 / sec
Upscalingcreative-upscaler$0.02 – $0.10 / req

Error Codes

CodeNameDescription
400Bad RequestMissing required fields or malformed JSON
401UnauthorizedMissing or invalid x-api-key header
402Payment RequiredInsufficient credits — top up your balance
403ForbiddenKey disabled or account suspended
429Too Many RequestsRate limit exceeded (30 req/min per key)
502Bad GatewayUpstream fal.ai returned an error
504Gateway TimeoutRequest timed out — retry with backoff

Rate Limits

Requests per minute30 / key
Concurrent requests5 / key
Response on limit429 Too Many Requests

Higher limits available on Pro plan. Use exponential backoff on 429s.