Gửi yêu cầu đầu tiên

Tạo cấu hình

Chọn công cụ và model, rồi chép đúng phần cấu hình. Chỉ những model hỗ trợ API mà công cụ của bạn dùng mới được liệt kê.

export ANTHROPIC_BASE_URL='https://api.nightrouter.ai'
export ANTHROPIC_AUTH_TOKEN='sk-nr-your-key'
export ANTHROPIC_MODEL='claude-fable-5'

Xác thực

Gửi key dưới dạng Bearer token trong header Authorization. Các client kiểu Anthropic có thể gửi key trong header x-api-key.

Gửi yêu cầu

Một lệnh gọi tối giản tới endpoint chat completions. Hãy thay chữ giữ chỗ bằng key của bạn.

curl https://api.nightrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-nr-your-key" -H "Content-Type: application/json" \
  -d '{"model":"claude-fable-5","messages":[{"role":"user","content":"Hello"}]}'

Model & giá

Dùng một model id trong thư viện model. Giá niêm yết theo 1M token hoặc theo request, và mức dùng của bạn được ghi trong nhật ký ở dashboard.

Claude Code

Claude Code đọc endpoint và key từ biến môi trường. Thêm các dòng này vào tệp cấu hình shell, rồi chạy claude.

export ANTHROPIC_BASE_URL='https://api.nightrouter.ai'
export ANTHROPIC_AUTH_TOKEN='sk-nr-your-key'
export ANTHROPIC_MODEL='claude-fable-5'

Codex CLI

Codex CLI dùng Responses API. Thêm provider này vào tệp cấu hình của nó và xuất key thành NIGHTROUTER_API_KEY.

model = "your-model-id"
model_provider = "nightrouter"

[model_providers.nightrouter]
name = "NightRouter"
base_url = "https://api.nightrouter.ai/v1"
env_key = "NIGHTROUTER_API_KEY"
wire_api = "responses"

# export NIGHTROUTER_API_KEY="sk-nr-your-key"

Coding agent

Trong các công cụ như Cline, Roo Code hoặc Cursor, chọn tuỳ chọn provider tương thích OpenAI, đặt base URL là https://api.nightrouter.ai/v1 và dán key của bạn.

API Provider  OpenAI Compatible
Base URL      https://api.nightrouter.ai/v1
API Key       sk-nr-your-key
Model ID      claude-fable-5

OpenAI API Key            sk-nr-your-key
Override OpenAI Base URL  https://api.nightrouter.ai/v1
Add custom model          claude-fable-5

Cùng base URL và key này cũng có thể dùng được ở các công cụ khác cho phép đặt base URL tương thích OpenAI tuỳ chỉnh, ví dụ Kilo Code, Continue và Zed.

SDK

Trỏ các SDK chính thức tới NightRouter bằng cách đổi base URL và key.

from openai import OpenAI

client = OpenAI(base_url="https://api.nightrouter.ai/v1", api_key="sk-nr-your-key")
r = client.chat.completions.create(model="claude-fable-5", messages=[{"role": "user", "content": "Hello"}])
print(r.choices[0].message.content)

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({ baseURL: "https://api.nightrouter.ai", apiKey: "sk-nr-your-key" });
const msg = await client.messages.create({ model: "claude-fable-5", max_tokens: 1024,
  messages: [{ role: "user", content: "Hello" }] });

Ứng dụng chat

Các ứng dụng chat cho phép đặt base URL tương thích OpenAI tuỳ chỉnh, ví dụ Cherry Studio, LobeChat, Open WebUI, LibreChat hoặc TypingMind, có thể trỏ tới NightRouter: thêm một provider tuỳ chỉnh với base URL https://api.nightrouter.ai/v1 và key của bạn.

Tài liệu API

Các endpoint này nằm dưới https://api.nightrouter.ai và dùng chung một key.

curl https://api.nightrouter.ai/v1/responses \
  -H "Authorization: Bearer sk-nr-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"your-model-id","input":"Hello"}'

curl https://api.nightrouter.ai/v1/messages \
  -H "x-api-key: sk-nr-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-fable-5","max_tokens":1024,"messages":[{"role":"user","content":"Hello"}]}'

Lỗi & giới hạn

Lỗi dùng mã trạng thái HTTP chuẩn, và phần thân phản hồi thường có thông báo lỗi.

Đây là mô tả chung về các lỗi thường gặp, không phải cam kết về chất lượng dịch vụ.