Supported providers
Endpoint families
Flatkey supports several endpoint families, each with its own request format:OpenAI (chat completions)
POST
/v1/chat/completions — used by GPT models and most non-Google providers. OpenAI-compatible JSON format.OpenAI (responses)
POST
/v1/responses — the newer OpenAI Responses API. Supports stateful multi-turn conversations.Gemini
Gemini models can also be called via the standard
/v1/chat/completions endpoint — Flatkey handles the translation automatically.Anthropic
Claude models are accessible via the OpenAI-compatible endpoint. You can also use the native Anthropic SDK with Flatkey.
Image Generation
POST
/v1/images/generations — supports gpt-image-2 and other image models.Embeddings
POST
/v1/embeddings — create text embeddings for semantic search and RAG.Choosing a model
Every model in the Model Directory shows:- Official price: The per-million-token price the vendor charges
- After-bonus price: The effective price after applying top-up bonus credits
- 30-day success rate: Real production traffic data, not synthetic benchmarks
- Average latency: Measured on live requests through Flatkey
- Cost-sensitive workloads:
gpt-4o-mini,gemini-2.5-flash-lite,deepseek-v4-flash,qwen3.5-flash - High-quality generation:
gpt-4o,claude-sonnet-4,gemini-2.5-pro - Reasoning & research:
deepseek-v3,qwen3.7-max,claude-opus-4 - Image generation:
gpt-image-2,gemini-3-pro-image - Embeddings:
gemini-embedding-001
Model IDs
Use the model’s canonical ID exactly as listed in the Model Directory. For example:python
python
Model health
Flatkey tracks live health for every model based on real production traffic:- Success rate: Percentage of requests that completed successfully in the last 30 days
- Average latency: Time to first token or total response time
- Volume: Total requests and tokens over the period