Getting Started

Get connected to NekoCloud API in three steps.

1. Create an API Key

Sign in to the main site, open API Keys, and create a key.

The key is shown only once

Copy and save it right away. If you lose it, simply generate a new one (the previous key is revoked immediately).

2. 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 the list of available models, see the Model Plaza on the site.

3. Make Your First Request

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.