Quickstart

WorldRouter is a unified OpenAI-compatible endpoint for top AI models. This page walks you through the four things you need to start using it: an API key, the base URL, a connection test, and the model IDs you can call.

Get an API key

1. Open the API Keys dashboard.
2. Sign in or create a WorldRouter account.
3. Click Create API key, name it, and copy the generated key (format: sk-...).
4. Add credits on the Credits page so the key can make paid calls.

Base URL

Every WorldRouter request goes to the same OpenAI-compatible endpoint. Use this value for the base_url / baseURL field in any SDK or the target URL for direct HTTP calls:

https://inference-api.worldrouter.ai/v1

The URL above is resolved for the environment you are signed in to, so copy-paste works without further editing.

Verify the connection

Run one of the snippets below with your key in place of your_api_key. A successful call returns a chat completion JSON payload, which confirms the key, the base URL, and your network are all working:

curl https://inference-api.worldrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [{ "role": "user", "content": "Hello" }]
  }'

A successful response looks like this — the choices[0].message.content is the model’s reply, and the usage block shows the tokens billed against your credits:

{
"id": "chatcmpl-9f2abc123",
"object": "chat.completion",
"created": 1716240000,
"model": "gpt-5.4",
"choices": [
  {
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Hello! How can I help you today?"
    },
    "finish_reason": "stop"
  }
],
"usage": {
  "prompt_tokens": 9,
  "completion_tokens": 11,
  "total_tokens": 20
}
}

Supported models

These are the model IDs you can use to test the connection — drop any one of them into the model field of the verification request above to check whether that specific model is currently callable on your account. The full catalog with live pricing lives on the Models page.

Supported tools

WorldRouter works with any client that accepts a custom OpenAI-compatible base URL. Pick the integration path that matches how you use AI, and follow its setup guide:

• CLI agents: terminal agents including Codex, Claude Code, and OpenCode.
• VS Code extensions: the first-party Codex plugin and other extensions that read a custom OpenAI endpoint.
• Direct API: any application, SDK, or script that speaks the OpenAI /chat/completions protocol. See the API reference for full details.

What’s next

• Base URL for this environment: https://inference-api.worldrouter.ai/v1.
• Manage keys and view usage on the API Keys dashboard.
• Browse the full Models catalog with live pricing.
• Read the API reference for authentication, error codes, and privacy.