01

快速開始

NXIO 可直接替換 OpenAI API：設定 base URL、換上 NXIO key、選一個模型。

三個步驟

1. 在儀表板建立 API key（Dashboard → API keys）。完整 key 只顯示一次。

2. 把 OpenAI SDK 或 HTTP 客戶端的 base URL 指向 NXIO。

3. 用目錄中的 NXIO id 呼叫任何模型，例如 anthropic/claude-sonnet-5。

curl
curl https://api.nxioai.com/api/v1/chat/completions \
  -H "Authorization: Bearer $NXIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-5",
    "messages": [{"role": "user", "content": "Say hello"}]
  }'
TypeScript (openai)
import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://api.nxioai.com/api/v1',
  apiKey: process.env.NXIO_API_KEY,
  defaultHeaders: { 'X-Title': 'My App' }, // optional: shows up in your usage analytics
});

const res = await client.chat.completions.create({
  model: 'anthropic/claude-sonnet-5',
  messages: [{ role: 'user', content: 'Say hello' }],
});
console.log(res.choices[0].message.content);
console.log(res.usage); // prompt/completion/cached tokens + cost in USD
Python (openai)
import os
from openai import OpenAI

client = OpenAI(base_url="https://api.nxioai.com/api/v1", api_key=os.environ["NXIO_API_KEY"])
res = client.chat.completions.create(
    model="anthropic/claude-sonnet-5",
    messages=[{"role": "user", "content": "Say hello"}],
)
print(res.choices[0].message.content)
print(res.usage)

你會拿到什麼

回應遵循 OpenAI chat completion 結構。兩點是 NXIO 特有：回應 id 是你的 NXIO request id（可用於 GET /generation）；usage 永遠包含美元費用與快取 token 數。

usage
"usage": {
  "prompt_tokens": 1200,
  "completion_tokens": 300,
  "total_tokens": 1500,
  "prompt_tokens_details": { "cached_tokens": 1000, "cache_write_tokens": 0 },
  "completion_tokens_details": { "reasoning_tokens": 0 },
  "cost": 0.00546,
  "is_byok": false
}

Base URL

API 位於 /api/v1。若 SDK 會自行附加 /v1，同一組路由也可在 /v1 下使用。

用途URL
API basehttps://api.nxioai.com/api/v1
模型目錄https://api.nxioai.com/api/v1/models
OpenAPI 規格https://platform.nxioai.com/openapi.json