GenX Router API
One API, 40+ AI models. Generate text, images, video, and audio with a single REST endpoint. No provider keys to manage. Built-in billing, webhooks, sessions, and file uploads.
Why GenX Router
GenX Router gives you one API endpoint for 40+ AI models across text, image, video, and audio. Instead of managing separate API keys, SDKs, and billing accounts for every provider, you get a single key and a unified interface.
- 40+ models, one key — GPT-5.4, Claude, Gemini, Grok, Sora, Veo, Kling, and more. No provider accounts needed.
- Stateful sessions — Multi-turn chat with automatic context management, compaction, and tool use (web search, code execution, file analysis).
- File uploads — Upload PDFs, documents, and spreadsheets. Reference them in sessions across multiple messages.
- Webhooks — Get notified when jobs complete. No polling required for production workloads.
- Async by design — Submit a job, get a job ID, poll or receive a webhook. Works the same whether it takes 2 seconds or 2 minutes.
- Volume discounts — Higher tiers unlock better pricing and higher rate limits automatically as you grow.
Quick Start
Three steps to your first generation:
- Create an account — Sign up at genx.sh and get 500 free credits.
- Create an API key — Go to Dashboard → API Keys. Your key starts with
gnxk_. - Make your first call
https://query.genx.shAll endpoints are under
/api/v1.
How It Works
Authentication
Include your API key in every request using either method:
Authorization: Bearer gnxk_...(recommended)X-Api-Key: gnxk_...
Generate → Poll (or Webhook)
All generation is asynchronous. You submit a job and get back a job ID immediately.
- POST /api/v1/generate — pick a model, send params, get a
job_idback. - GET /api/v1/jobs/:id — poll until
statusiscompletedorfailed. - On completion,
result_urlcontains the output (text, image URL, video URL, etc.).
For production, register a webhook endpoint in your dashboard. GenX Router will POST to your URL when a job completes or fails — no polling needed. Webhook payloads include the full job result, usage metrics, and any metadata you attached.
Sessions (Multi-Turn Chat)
For conversational use cases, create a session instead of one-off generates. Sessions maintain message history, support system prompts, and handle context management automatically.
- Tool use — Models can call web search, code execution, and custom functions within a session.
- File context — Upload documents via
/api/v1/filesand reference them in messages. - Auto-compaction — When context fills up, summarize history to keep the conversation going.
- Idempotent messages — Pass an
idempotency_keyfor safe retries.
Metadata & Tracking
Attach up to 16 key-value pairs to any job via the metadata field.
Use it to tag jobs with your own user IDs, project names, or tracking codes.
Metadata is returned in job responses and webhook payloads.
Endpoints
Generate
| Field | Type | Description |
|---|---|---|
model | string | Model ID (e.g. claude-sonnet-4-6, grok-imagine). See model catalog. |
params | object | Model-specific parameters (prompt, dimensions, duration, etc.) |
metadata | object? | Optional key-value pairs (up to 16 keys, string values) |
Jobs
?status= filter and cursor pagination.Sessions
Files
Models
?category=text|image|video|audio.Account
?category=.Code Examples
Pricing
GenX Router uses credit-based billing powered by the DashNex Credits System — credits never expire and you can use them across the entire DashNex ecosystem. New accounts start with 500 free credits.
How Billing Works
- Submit a job — your balance is checked to ensure you have enough credits.
- Job completes — the actual cost is calculated from real usage metrics and charged on completion.
- Job failed? No charge. You only pay for successful generations.
Each model has per-metric pricing (tokens, images, audio seconds, video seconds, etc.).
Check per-model rates in the model catalog
or via GET /api/v1/account/pricing for your tier-adjusted prices.
Tiers
Tiers are earned automatically based on your cumulative top-up spend. Higher tiers get better pricing and higher rate limits.
| Tier | Discount | Rate Limit | Concurrency |
|---|---|---|---|
| Starter | — | 10 RPM | 2 |
| Blaze | 5% off | 60 RPM | 5 |
| Agent | 10% off | 200 RPM | 10 |
| Operator | 15% off | 500 RPM | 25 |
Enterprise
For companies building products on top of GenX Router, the Enterprise tier removes all rate limits and provides contract-based pricing.
Enterprise accounts get a Platform Secret that unlocks a powerful sub-key system:
- Sub-keys for your users — Programmatically create API keys scoped to individual users in your platform via the Platform API. Each key is tied to an external ID you control.
- Per-user usage tracking — Query usage by key or user. Build your own billing, quotas, or dashboards on top of GenX Router without managing any AI provider accounts.
- Zero-config onboarding — New users are auto-provisioned on first key creation. No manual setup, no waiting.
- Key lifecycle management — Create, list, and revoke keys programmatically. Full control over your user base.
This means you can offer AI capabilities to your own customers — text, image, video, audio — without integrating with a single provider directly. GenX Router handles the routing, billing, and infrastructure. You focus on your product.