Model API
Model API · Quick start
Model API connects your app or AI tool to models from different providers with one Felo API key. Use it for conversations, writing and coding, or choose image and video models for creative tasks. Usage is paid from your platform balance.
Quick start
- Get an API key — Create an API key in the console. Copy the full key and keep it safe.
- Top up your balance — Buy USD-denominated service credits from $1 and pay for actual API usage. No subscription required.
- View all models — Choose a model that supports Chat Completions from the catalog and replace YOUR_MODEL_ID below.
Use an AI tool
Configure Codex, Claude Code, DeepSeek Harness, OpenClaw, Cursor, Cline, and other agent clients.
Codex
Configure Codex CLI with a Felo custom model provider.
Claude Code
Configure Claude Code to route Anthropic-compatible model calls through Felo API Platform.
OpenClaw
Connect OpenClaw to Felo API Platform for assistant and agent workflows.
Hermes Agent
Configure Hermes Agent with Felo API Platform model access.
OpenCode
Connect OpenCode to Felo through the OpenAI-compatible endpoint.
DeepSeek Harness
Connect DeepSeek Harness to Felo through its native DeepSeek adapter or a custom OpenAI-compatible provider.
Cursor
Use Felo API Platform in Cursor through custom OpenAI-compatible settings where available.
Cline
Configure Cline with Felo API Platform model access.
Pi
Install the Felo Skill for Pi and optionally add Felo as a Pi model provider.
TRAE
Use Felo API Platform from TRAE through compatible model provider settings.
Roo Code
Configure Roo Code with a Felo-compatible model provider.
Kilo Code
Configure Kilo Code with Felo API Platform model access.
Connect your own application
Keep your OpenAI or Anthropic SDK. Enter the matching Base URL, your Felo API key and a supported model ID.
OpenAI SDK · Base URL
https://openapi.felo.ai/api/v1Anthropic SDK · Base URL
https://openapi.felo.ai/apiAnthropic SDKs append /v1/messages. Set the base URL to /api, without a trailing /v1. Use your Felo key as the SDK API key.
Quick start · Chat Completions
Choose a model that supports Chat Completions from the catalog and replace YOUR_MODEL_ID below.
export FELO_API_KEY="YOUR_FELO_API_KEY"
curl -sS https://openapi.felo.ai/api/v1/chat/completions \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"Say hello"}]}'HTTP 200 → choices[0].message.content
Protocol and authentication details
Felo-compatible model and video APIs. The model endpoints include OpenAI-compatible Models, Chat Completions, and Responses APIs, plus the Claude-compatible Messages API. Authenticate model and video requests with a Felo API key using Bearer authentication or the X-API-Key header. Submit video tasks asynchronously, poll until status is succeeded, then download the signed output media URL from outputs[]. The media download endpoint is anonymous: each output URL carries a short-lived HMAC signature (exp + sig) and can be opened directly in a browser without an API key. Chat Completions, Responses, and Messages preserve their respective protocol request, response, streaming, and error shapes. GET/HEAD /api/platform/model-catalog is an anonymous, locale-aware directory for model discovery and Playground forms. Inference still requires an API key. All six inference protocols accept X-Felo-Channel; published channels control routing. Images use persistent async tasks and Decisions uses non-streaming state/questions.
Authentication
Bearer token
FeloBearerAuth
Request header
Authorization: Bearer <FELO_API_KEY>Felo API key sent as Authorization: Bearer <key>.
API key
FeloApiKey
Request header
X-API-Key: <FELO_API_KEY>Felo API key sent as X-API-Key: <key>.