Model API
Call any Coarena model from your own code. The free models are free every day, and Coarena pays; credits unlock every model.
Quick start
- Get a key Create one on your API page. Free, no card.
- Set the base URL
https://coarena.ai/api/v1for OpenAI SDKs,https://coarena.ai/apifor Anthropic's. - Call Any model id from the list, as the
model.
curl https://coarena.ai/api/v1/chat/completions \
-H "Authorization: Bearer $COARENA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "claude-fable-5",
"messages": [{"role": "user", "content": "Hello"}]}'Base URLs
One key, two base URLs: every model answers on both.
# OpenAI SDKs, Codex, LangChain
export OPENAI_BASE_URL=https://coarena.ai/api/v1
export OPENAI_API_KEY=$COARENA_API_KEY
# Anthropic SDK, Claude Code
export ANTHROPIC_BASE_URL=https://coarena.ai/api
export ANTHROPIC_AUTH_TOKEN=$COARENA_API_KEYModels
24 models today. Send any id as the model; the list needs no key.
curl https://coarena.ai/api/v1/modelsAll 24 model ids
claude-fable-5claude-fable-5-1claude-fable-5-2claude-haiku-5-5claude-opus-5-5claude-sonnet-5-5deepseek-v4-1-flash-1017gemini-3-8-flashgemini-4-argongemini-4-carbonglm-5-3-flashgpt-6-1-solgpt-6-1-terragpt-6-2-astragpt-6-2-solgpt-6-astragpt-6-lunagrok-4-7hy4kimi-k3kimi-k3-1-promimo-v2-6-prominimax-m3-1-flashqwen3-8-2-4t-a95b
Feedback
Rate any reply up or down by the id it came with, and say why: tags (correct, helpful, fast, wrong, unhelpful, refused, too_slow, bad_format, unsafe, concise, thorough, creative, good_code, followed_instructions, made_up, incomplete, too_long, off_topic, bad_code, ignored_instructions) and a note of up to 2,000 characters. null takes the rating away.
curl https://coarena.ai/api/v1/feedback \
-H "Authorization: Bearer $COARENA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"request_id":"<reply id>","rating":"up"}'
# Python (openai), after reply = client.chat.completions.create(…)
client.post("/feedback",
body={"request_id": reply.id, "rating": "up"}, cast_to=object)Limits
Free: the free models, every day, and Coarena pays. Credits unlock every model with no daily limit. 30 requests a minute, 2 at once. An account may also have a daily request limit, set by Coarena.
curl https://coarena.ai/api/v1/limits \
-H "Authorization: Bearer $COARENA_API_KEY"Asking for more
One call, after your first one. With no field it asks for the next step up, $5 a day; name requests_per_minute (up to 600), or requests_per_day if your account has a daily request limit, to ask for those.
curl https://coarena.ai/api/v1/limits/requests \
-H "Authorization: Bearer $COARENA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usd_per_day":5}'
# More a minute: -d '{"requests_per_minute":60}'
# Where it stands: GET /api/v1/limits
# Withdraw it: DELETE /api/v1/limits/requests/currentErrors
OpenAI routes answer in OpenAI's error shape, /v1/messages in Anthropic's. A limit 429 says exactly how to ask for more.
{
"error": {
"type": "insufficient_quota",
"code": "insufficient_quota",
"message": "Today's free usage is used up. It resets at 00:00 UTC, …",
"limit_increase": {
"ask": {
"method": "POST",
"url": "https://coarena.ai/api/v1/limits/requests",
"body": {
"usd_per_day": 5
}
}
}
}
}Everything by API
Everything on your API page, with a key. Scopes and examples are in the API reference.
| What | Call |
|---|---|
| Call a model | POST /api/v1/chat/completions, /responses or /messages |
| List the models | GET /api/v1/models |
| Today's use and your limits | GET /api/v1/limits |
| Ask for higher limits | POST /api/v1/limits/requests |
| Withdraw that ask | DELETE /api/v1/limits/requests/current |
| Your credits | GET /api/v1/credits |
| Usage by day, model and key | GET /api/v1/usage |
| Your requests | GET /api/v1/requests |
| One request | GET /api/v1/requests/{id} |
| Rate a reply | POST /api/v1/feedback |
| Download requests | GET /api/v1/requests/export |
| Your keys | GET /api/v1/keys |
| Rename or revoke this key | PATCH or DELETE /api/v1/key |