API05

One endpoint. Your own key.

XCurOS speaks the OpenAI protocol, the Anthropic Messages API and the Responses API on a single address, so the SDK and the editor you already use need a base URL and nothing further. A key is issued in about a minute, automatically, at any hour.

Base URL
https://xcuros.com/v1
Authentication
Authorization: Bearer YOUR_KEY
Model
xcuros-2.2-max
Protocols
OpenAI Chat Completions · Anthropic Messages · OpenAI Responses
Context
200,000 tokens as served · streaming, tool calling, vision, document understanding and web search on every protocol

Get your key

Your email address, a six-digit code, and the key is on screen. There is no account to create and no password to manage: the mailbox is the account, and it is also how a lost key is recovered — confirm the same address again and the same key is returned, not a new one.

Loading…

What the key opens

A verified email address opens xcuros-2.2-max — our own model, the one the Playground runs and the model card documents. That is the complete free tier, and it requires nothing further.

The phone number is optional

Verifying a phone number unlocks the hosted models. It is one confirmation on Telegram — no SMS, and nothing to pay. Skip it and your key continues to work exactly as it is.

What a free key includes

Ninety days, renewed by confirming your address again. The key's value does not change on renewal, so nothing you have configured stops working. Within that period: 500 requests a day · 20M tokens a calendar month.

Need more than that?

Higher limits, a longer validity period, on-premise deployment or a licence — contact us and a member of the team will reply.

How each model is unlocked

Email verifiedAll developers
xcuros-2.2-max

Our own model, served on hardware we operate ourselves — which is why a verified address is all it takes. Advanced reasoning, native vision, document understanding and a 200,000-token context window as served.

  • Chat Completions, Messages and Responses
  • Reasoning on every request
  • Tool calling, streaming, images and PDFs
Phone verifiedOptional
glm-5.3-flash · kimi-k3 · deepseek-v4.1-flash

Hosted by other providers, on a free allowance shared across all XCurOS developers. A single confirmation on Telegram unlocks them, and no SMS is ever sent.

  • Added to the key you already hold — its value does not change
  • The number identifies your account and is used for nothing else
  • Never required — xcuros-2.2-max remains available either way

The call

Point the SDK you already use at the base URL above. Nothing else in your code changes.


      

Editors and terminal agents

Pick yours. The steps open here, with your own values already in them.

Every one of these was checked against this endpoint. A client that cannot be pointed at it is not in the list.

When a request is refused

Every refusal carries an actionable reason in the response body. These are the five you are most likely to encounter.

StatusWhat happened, and what resolves it
400The request is longer than the context window it was sent to. The body names context_length_exceeded (or prompt is too long on the Anthropic route) and carries both figures — what was sent and what the model accepts — so an agent can trim and retry without guessing. POST /v1/messages/count_tokens answers the same question before the upload is spent.
401The key is missing, mistyped or expired. Confirm your address again on this page — the same key is returned, and an expired key is extended without its value changing.
403The key is valid, but that model is not on it. The hosted models require the phone step; xcuros-2.2-max never does.
429A rate limit — either your own (500 requests a day) or the shared allowance behind a hosted model. Wait, or contact us for a key with higher limits.
5xxThe endpoint is not answering. A 503 carrying Retry-After is ours and means the model is reloading — retry in a few seconds. Anything else was raised at the edge rather than by us, and the Uptime page reports the current state of the service.

The same model our customers run

A free key reaches the same endpoint, the same model and the same weights as a licensed deployment. It is bounded by duration and by usage, never by capability. When those bounds become the constraint, that is a commercial conversation rather than a different product.

Talk to us about a licence