Felo API PlatformFelo API Platform

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

  1. Get an API key — Create an API key in the console. Copy the full key and keep it safe.
  2. Top up your balance — Buy USD-denominated service credits from $1 and pay for actual API usage. No subscription required.
  3. 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.

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/v1

Anthropic SDK · Base URL

https://openapi.felo.ai/api

Anthropic 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

Set up manually · Protocols and SDKs

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>.

Need help?