Quickstart

This page walks you through your first XNova setup: sign up and top up, create an API key, and point your client at XNova. It takes about five minutes.

Before you start

• Sign up and log in at XNova.
• Add balance on the top-up page. Your balance works across every group; see Billing.
• Create an API key and pick a group, as described in Create API Key.

Base URL

Node	Base URL	Notes
Main	https://api.xnova.online/v1	Default
Overseas optimized	https://cf-api.xnova.online/v1	Use when the main node is slow; same account and balance

Most clients only need two fields:

Base URL: https://api.xnova.online/v1
API Key: sk-your-xnova-key

Claude Code uses the Anthropic format without /v1; see Claude Code.

Commonly used models:

gpt-6.1-sol
gpt-6-astra
claude-opus-5-5
deepseek-v4.1-flash
gpt-image-2.5

Pick a client

• Agents: Codex, Codex++, Claude Code, OpenCode
• ChatBots: Cherry Studio, RikkaHub

Verify

curl https://api.xnova.online/v1/models \
  -H "Authorization: Bearer sk-your-xnova-key"

If you get a model list back, your key and base URL are working.