Claude & GPT API Docs: Keys, SDKs, Clients

One key and two compatible base URLs for production models, clients, and media APIs.

For an AI agent

Stuck? Hand it to an AI agent

Send the link below to any AI agent (Claude Code, Codex, Cursor…) and ask it to set up your client: it has everything an agent needs, from each client's settings to the check.

Three steps

1. Get a key in the cabinet

   Open the cabinet, top up the balance (or redeem a marketplace code) and press “Issue a key”.

   app.oneprovider.dev Telegram bot How it works

2. Pick your client

   Each client has its own short guide.

   • Claude Code
   • Claude Desktop
   • Codex (OpenAI)
   • Cursor
   • Hermes Agent
   • Cline
   • OpenClaw
   • VS Code
   • OpenCode
   • Open Cowork
   • Factory Droid
   • n8n
   • Python SDK
   • Node SDK

3. Set the base URL and key

   The key goes in the x-api-key or Authorization: Bearer header. The address depends on the client type:

   Anthropic (Claude Code, Anthropic SDK), no /v1 https://api.oneprovider.dev OpenAI (Codex, Cursor, OpenAI SDK), with /v1 https://api.oneprovider.dev/v1 bash

   curl -s https://api.oneprovider.dev/v1/models \
   -H "Authorization: Bearer sk-your-key-here"

   A list of models in the reply means the key works.

Next

• Models & pricing
• Authentication
• Messages API
• Chat Completions
• Cabinet & keys
• Errors & diagnostics

Quick answers

Which base URL do I use?

Claude Code and Anthropic SDKs use https://api.oneprovider.dev. OpenAI SDKs and OpenAI-compatible clients use https://api.oneprovider.dev/v1. One key works behind both; the model list is on the models page ; rates are on the pricing page .

How do I authenticate?

Send the raw sk-… key in x-api-key or Authorization: Bearer: one of them, never both. Keep the key in an environment variable, not in a file that gets committed. More on authentication .

Where do I get a key?

Open your cabinet in the Telegram bot @oneprovider_robot or at app.oneprovider.dev, top up the balance and press “Issue a key”. Each key can carry its own spend limit. Cabinet & API keys .

What do 401, 404 and 429 mean?

401: the key is missing, mistyped or sent in the wrong header; paste the whole key without quotes or spaces. 404: usually a wrong base URL, for example a missing or doubled /v1. 429 with “Insufficient balance”: the cabinet balance or the key’s spend limit is used up, so top up instead of retrying; any other 429 is a rate limit, so wait for Retry-After. Details: error codes and troubleshooting .

Why do streams cut off or reset?

VPN and VLESS proxies often buffer SSE or break HTTP/2 negotiation. OneProvider has no regional restrictions and does not buffer streams, so turn the proxy off and retry.

Where do I ask if this is not enough?

Message @Oneproviderhelpbot on Telegram or open “Support” in the web cabinet, with the HTTP status code and the exact error message. How support works .