NovaAPI Documentation

One OpenAI-compatible API for frontier Chinese models — DeepSeek V4 native, plus Claude-compatible endpoints for Claude Code & the Anthropic SDK.

Quick Start

If you have ever used an OpenAI-compatible API, you already know how to use NovaAPI: point your client at our base URL, use your key, pick a model.

1. Create your account

1. Open https://api.lbase.com/register.
2. Enter your email and a password (min. 6 characters).
3. That's it — no Chinese phone number, no ID verification, no credit card required to register.

2. Top up your balance

NovaAPI is pay-as-you-go: you prepay a USD balance, and every request deducts from it by tokens used. No subscription.

1. Log in and open Balance / Top Up (or click a quick amount).
2. Choose a payment method:
   • PayPal — you'll be redirected to PayPal to approve the payment.
   • USDT (TRC20) — you'll get a TRON address; send USDT from any TRC20 wallet (keep a little TRX for network fees).
3. Your balance is credited with the exact amount received once the payment confirms.

3. Create an API key

1. Open API Keys → Create Key in the console.
2. Give it a name (e.g. my-app).
3. Select a group (channel):
   • DeepSeek — native model names (deepseek-v4-flash, deepseek-v4-pro, deepseek-v4-flash-vision-exp).
   • Claude Compatible — Claude model names (Sonnet / Haiku / Opus / Fable) routed to our DeepSeek backends, for Claude Code & Anthropic SDK users.
4. Copy the sk-... key. It is shown only once — treat it like a password.

Base URL

Use this endpoint everywhere a tool asks for an API address:

https://api.lbase.com/v1

Anthropic-format clients (Claude Code, Anthropic SDK) point at the root host — they append /v1/messages themselves:

https://api.lbase.com

Hello world

# cURL
curl https://api.lbase.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

# Python (OpenAI SDK)
from openai import OpenAI

client = OpenAI(
    api_key="sk-your-key-here",
    base_url="https://api.lbase.com/v1",
)
resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(resp.choices[0].message.content)

# Node.js (OpenAI SDK)
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-your-key-here",
  baseURL: "https://api.lbase.com/v1",
});
const resp = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [{ role: "user", content: "Hello!" }],
});
console.log(resp.choices[0].message.content);

Connect your tools

NovaAPI speaks both the OpenAI and Anthropic protocols, so it works with almost any AI tool that lets you set a base URL. Below are the most popular setups.

Claude Code (terminal coding agent)

Claude Code is Anthropic's CLI coding agent. Point it at NovaAPI with two environment variables — or, more reliably, with its config file:

# Option A — environment variables (Linux / macOS)
export ANTHROPIC_BASE_URL=https://api.lbase.com
export ANTHROPIC_AUTH_TOKEN=sk-your-key-here
export ANTHROPIC_MODEL=deepseek-v4-flash

claude

# Option B — ~/.claude/settings.json (applies to every session, most reliable)
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key-here",
    "ANTHROPIC_BASE_URL": "https://api.lbase.com",
    "ANTHROPIC_MODEL": "deepseek-v4-flash"
  }
}

• Use a Claude Compatible group key if you want to keep the default Claude model names (claude-sonnet-5 etc. work out of the box).
• You can also use a DeepSeek group key and set ANTHROPIC_MODEL=deepseek-v4-flash (or deepseek-v4-pro).
• Claude Code prints a harmless warning that the model name is unknown to its catalog — ignore it.

After setup, launch claude in your terminal — you should see the model badge deepseek-v4-flash · API Usage Billing at the bottom and normal replies. The first launch asks about the workspace folder and theme; answer them once and you're set.

Cursor

1. Open Cursor → Settings → Models.
2. Scroll to OpenAI API Key section → enable Override OpenAI Base URL.
3. Set Base URL: https://api.lbase.com/v1 and API key: sk-....
4. Add a model name (e.g. deepseek-v4-flash) and select it in the model picker.

In Cursor open Settings → Models, enable Override OpenAI Base URL and paste the endpoint above — then add deepseek-v4-flash as a model.

Codex CLI (OpenAI)

Create or edit ~/.codex/config.toml (Windows: %userprofile%\.codex\config.toml):

model_provider = "novaapi"
model = "deepseek-v4-flash"
review_model = "deepseek-v4-flash"
disable_response_storage = true

[model_providers.novaapi]
name = "NovaAPI"
base_url = "https://api.lbase.com/v1"
env_key = "NOVAAPI_API_KEY"

# then export the key (Linux/macOS) or set in PowerShell (Windows)
export NOVAAPI_API_KEY=sk-your-key-here
# PowerShell: $env:NOVAAPI_API_KEY="sk-your-key-here"

codex

Save the snippet above as your Codex config and run codex — the CLI will use NovaAPI for all requests.

OpenCode

OpenCode reads opencode.json in your project:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "novaapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "NovaAPI",
      "options": {
        "baseURL": "https://api.lbase.com/v1",
        "apiKey": "sk-your-key-here"
      },
      "models": {
        "deepseek-v4-flash": { "name": "DeepSeek V4 Flash" }
      }
    }
  }
}

OpenAI SDK & libraries

Any OpenAI-compatible SDK works: set base_url/baseURL to https://api.lbase.com/v1 and use your key — see the Hello World examples above. LangChain, Vercel AI SDK, LlamaIndex and similar frameworks all accept a custom OpenAI-compatible base URL.

Models & pricing

Per-token pricing in USD. You only pay for what you use.

DeepSeek group (×2.5 list rates)

Claude Compatible group (×3.5 list rates)

Which models actually work?

Only the models listed in the tables above (and in the console when you create a key) are callable. Client apps sometimes show long historical model lists from upstream providers — those older names (e.g. deepseek-v3, deepseek-r1, distill variants) return an error if requested. When in doubt, use deepseek-v4-flash.

Billing, limits & usage

• Balance is prepaid in USD and deducted per request; top up any time from the console.
• Minimum top-up is US$5 (PayPal or USDT).
• Usage page shows requests, tokens and cost per key, per day.
• Rate limiting: per-key concurrency is generous; under heavy parallel load requests queue briefly instead of failing. Add more keys in the console to scale.

Every request is recorded per model — including Claude-compatible names, as shown in the recent usage list below (Claude Code / client requests appear with their model names and exact cost):

FAQ

Do I need a Chinese phone number?

No. Register with any email address — no Chinese phone, no ID verification, no VPN.

Is my existing OpenAI code compatible?

Yes. Set base_url to https://api.lbase.com/v1 and keep everything else unchanged.

Can I use Claude Code / Anthropic SDK?

Yes — we support the Anthropic Messages protocol at https://api.lbase.com/v1/messages. Point Claude Code at https://api.lbase.com with a Claude Compatible key (or set ANTHROPIC_MODEL to a deepseek model with a DeepSeek key).

Which models are available?

DeepSeek V4 (native) and Claude-compatible endpoints. More Chinese model families (Qwen, GLM, Kimi, MiniMax) are being onboarded and will appear in the console.

Why did my USDT top-up credit a different amount?

You are credited with the exact amount received on-chain. Exchange withdrawals deduct a fee before the transfer lands, so the on-chain amount may be lower than what you sent. Always make one single transfer for the full amount you want.

Do you offer refunds?

Top-ups are non-refundable except where required by law (see Terms). Unused prepaid balances remain available for future usage.

Where is my data processed?

Requests are forwarded to the model provider you use to fulfill them. See the Privacy Policy on our homepage. Don't send sensitive data you are not comfortable sharing with a third-party model provider.

Support

Questions or issues? Email hello@lbase.com. Include your account email and, if relevant, the order or key involved.