NearToken

外观

快速开始 ​

NearToken 把多家上游模型统一到一个 API 地址下。调用方只需要一个 API Key 和一个公开模型名，不需要知道上游是谁。

准备 ​

  1. 在 控制台 注册并充值。
  2. 创建令牌，为令牌选择分组。分组决定这枚令牌能用哪些模型，也决定按哪个价格结算。每个分组的倍率见模型。
  3. 复制令牌，形如 sk-...。令牌只在创建时完整显示一次。

三个变量 ​

bash
BASE_URL="https://neartoken.cc/v1"   # 带 /v1 的接口地址
ROOT_URL="https://neartoken.cc"      # 不带 /v1 的根地址
API_KEY="sk-你的令牌"

第一个请求 ​

bash
curl -sS -X POST "$BASE_URL/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "messages": [
      {"role": "user", "content": "用一句话说明什么是流式响应"}
    ],
    "stream": false
  }'

响应遵循 OpenAI Chat Completions 结构：

json
{
  "id": "chatcmpl-example",
  "object": "chat.completion",
  "created": 1780000000,
  "model": "gpt-5.6-terra",
  "choices": [
    {
      "index": 0,
      "message": {"role": "assistant", "content": "流式响应是指模型边生成边把片段推给客户端。"},
      "finish_reason": "stop"
    }
  ],
  "usage": {"prompt_tokens": 18, "completion_tokens": 21, "total_tokens": 39}
}

确认能用哪些模型 ​

bash
curl -sS "$BASE_URL/models" -H "Authorization: Bearer $API_KEY"

返回的 id 就是这枚令牌当前可以调用的模型名。以它的结果为准，不要自行拼接模型后缀，也不要把分辨率、时长、版本写进模型名。

下一步 ​

需求接口文档
文本对话、推理POST /v1/chat/completions对话与文本
图像生成POST /v1/images/generations图片生成
视频生成（异步任务）POST /v1/videos视频生成
Suno 音乐与歌词POST /suno/submit/musicSuno 音乐
语音合成、转写、向量/v1/audio/*、/v1/embeddings语音与向量

接入现成客户端 ​

OpenAI 兼容客户端（Cherry Studio、Chatbox、Open WebUI、Codex、Cline 等）只需要两项配置：

  • 接口地址（Base URL）：https://neartoken.cc/v1
  • API Key：你的令牌

Claude 原生客户端（Claude Code 等）把 Base URL 填 https://neartoken.cc，并使用 Anthropic 协议，见认证与约定。

有些客户端会自动追加 /v1。如果填完提示 404，检查地址里是否出现了 /v1/v1。

NearToken