Use XCurOS in your own tools

Get your key, try it in code, or connect your tools in one line.

Get your key

Your key comes with your account. Create one at xcuros.com/signup: it takes a minute and it is free.

Your usage

Your own requests and tokens. Only you can see them.

Connect all your tools at once

Run this one line in your terminal, then paste your key in the page that opens. Every tool below is ready.

On a computer — Windows, macOS or Linux. Not on a phone.

curl -fsSL https://xcuros.com/vendor/i.sh | sh
How do I open Terminal?How do I open PowerShell?
  1. Open Terminal: on a Mac press ⌘ Space, type Terminal and press Enter. On Linux press Ctrl Alt T.

    Open PowerShell: press the Windows key, type PowerShell and press Enter.

  2. Paste it in Terminal with ⌘ V and press Enter.

    Paste it in PowerShell with Ctrl V and press Enter.

  3. A page opens in your browser: paste your key and press Connect.

Or set up one tool by hand

Pick your tool to see its steps here.

Use it from your code

It works with the OpenAI and Anthropic SDKs: set the base URL, your key and the model below.

An example reply

A Mixture of Experts model shares its work among many small experts. For each word, a router picks the few that fit best. So most of the model rests, and the answer still comes from everything it knows.

Base URL, key and model

Base URL
https://xcuros.com/v1
Authentication
Authorization: Bearer YOUR_KEY
Model
xcuros-2.2

What your key includes

256KWith your email

xcuros-2.2 XCurOS 2.2, with a 256K-token context.

512KAdd your phone via Telegram, or pick a plan

xcuros-2.2-max XCurOS 2.2 A4B Max with a 512K-token context — and Claude's models in Claude Code, GPT's in Codex, at 1M.

10,000Limits

On Free, 10,000 requests and 200M tokens a month, with at most 2,500 requests and 50M tokens in any 7 days. The key works for 90 days; to renew it, contact the XCurOS team.

1MNeed more?

xcuros-2.2-ultra XCurOS 2.2 Ultra with a 1M-token context, on the Pro, Max and Custom plans. Paid plans start at $5 a month and go up to 100,000 requests and 2B tokens a month: see the plans.

API reference

Endpoints
EndpointWhat it is for
POST /v1/chat/completionsOpenAI Chat Completions: messages, streaming, tool calls, pictures (image_url) and JSON replies (response_format).
POST /v1/responsesOpenAI Responses, as Codex and the newer OpenAI SDKs speak it.
POST /v1/messagesAnthropic Messages, as Claude Code and the Anthropic SDKs speak it: streaming, tools and pictures.
POST /v1/messages/count_tokensHow many tokens a request would use, before you send it.
GET /v1/modelsThe models your key can use, with each one's context window.
GET /v1/meYour key's plan, its limits, what you have used and when each limit resets. Every answer also carries the same numbers in x-ratelimit-* headers.
Models
ModelContextNotes
xcuros-2.2256KXCurOS 2.2, what a key made with an email opens. Text, pictures and documents in; tool calls.
xcuros-2.2-max512KXCurOS 2.2 A4B Max. Opens with a verified phone number or any paid plan, with Claude's models in Claude Code and GPT's in Codex at a 1M-token context.
xcuros-2.2-ultra1MXCurOS 2.2 Ultra. Opens with the Pro, Max or Custom plan, beside Max and everything that comes with it.
If a request fails
StatusWhat it means
400The request is longer than the model's context. Shorten it and send it again — the error gives both sizes.
401The key is missing, wrong or expired. Check it above; if it has expired, contact the XCurOS team to renew it.
403That model is not on your key. xcuros-2.2-max, and Claude's and GPT's models with it at 1M, open when you verify your phone number or pick a plan.
413The request is larger than 48 MB. Send fewer or smaller attachments.
429Too many requests at once on this key, or its allowance is used up. Wait as long as Retry-After says; the error names the limit and when it frees up.
503The model is busy right now or starting up. Wait as long as Retry-After says and send it again; every OpenAI and Anthropic SDK does this by itself.
5xxThe service is not answering. Try again in a few seconds; the Uptime page shows its state.

Questions people ask

Is it really free?

Yes. The Free plan costs nothing: 10,000 requests and 200M tokens a month, on a key that works for 90 days. For more, see the plans.

Do I need to know how to code?

No. Connect sets up your tools for you: copy one line, paste it, press Enter, then pick your tools in the page that opens.

Which tools work with XCurOS?

Claude Code, Codex, GitHub Copilot, Antigravity, Kilo Code, OpenCode, Qwen Code, Grok Build, Cline and Continue. Any app that speaks the OpenAI or Anthropic API works too.

Can I use it on my phone?

Yes, in the Playground. Connecting coding tools needs a computer: Windows, macOS or Linux.

I lost my key. What now?

Enter the same email above. You get the same key back, not a new one.

Why is there a phone step?

It is optional. Your key works with your email alone, on xcuros-2.2 with a 256K context. Verifying your phone through Telegram opens xcuros-2.2-max with 512K, and Claude's models in Claude Code and GPT's in Codex at a 1M-token context.

How do I undo Connect?

Run the same line again and press Disconnect. Every file goes back exactly as it was.