Getting Started

From sign-up to your first call — about 5 minutes.

1. Create an account

Open the main site and sign up (email registration requires email verification before you can sign in).

Registration currently accepts qq.com, 163.com, 126.com and gmail.com; follow the registration page for changes. An unsupported email domain is different from a missing verification email.

2. Top up your balance

NekoCloud API is pay-as-you-go — top up to start calling: ¥1 paid adds $1 of site credit, not foreign-exchange conversion.

Sign in and open the Recharge page, check the currently available payment methods; if none is shown, contact support. See Billing & Top-up.

3. Create an API key

Open API Keys, check the available group and target model access, then create a key. See Keys and groups.

The key is shown only once

Copy and save it right away. If you lose it, delete the old key first and then create a replacement. Creating another key alone does not revoke the old one.

4. Base URLs

Protocol	Base URL	Works with
OpenAI-compatible	https://api.nekocloud.vip/v1	OpenAI SDK, Cursor, Codex, etc.
Anthropic-compatible	https://api.nekocloud.vip	Claude Code, Anthropic SDK, etc.
Gemini-compatible	https://api.nekocloud.vip/v1beta	Gemini ecosystem tools

For available models and live prices, see the Model Plaza.

5. Make your first request

These examples require a text model supporting Chat Completions. For Responses models, see Codex setup. Install the corresponding OpenAI SDK first (use a Python virtual environment, or install openai in your Node.js project). Replace the key and model placeholders. A test request may incur charges.

curl

curl https://api.nekocloud.vip/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-name",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    base_url="https://api.nekocloud.vip/v1",
    api_key="sk-your-key",
)

resp = client.chat.completions.create(
    model="your-model-name",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

Node.js（OpenAI SDK）

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.nekocloud.vip/v1",
  apiKey: "sk-your-key",
});

const resp = await client.chat.completions.create({
  model: "your-model-name",
  messages: [{ role: "user", content: "Hello" }],
});
console.log(resp.choices[0].message.content);

More client setups: Client Setup.