1110 API 新手使用教程

欢迎使用 1110 API。本教程带你从注册到在常用工具里跑起来，全程约 5 分钟。遇到问题先翻第 14 章「常见报错排查」，大部分问题都能自己解决；解决不了再进第 15 章的售后群。

01 购买后使用流程

本站通过 CDK 兑换码购买额度，完整链路一共四步：

注册账号：打开 https://api.1110.fyi 注册，用邮箱收验证码完成验证
兑换 CDK：登录后进入「钱包」，找到兑换入口，粘贴你的 CDK 兑换码提交，相应额度立即到账（在钱包余额里确认到账数字）
创建令牌（Key）：进入「API 密钥」页面新建一个令牌，创建时选好分组（分组是什么看第 04 章）
填进工具使用：把接口地址和令牌填到你的客户端里（第 08~13 章按工具分开讲）

CDK 从官方售后群获取（见第 15 章）。

CDK 常见问题

兑换码用不了：依次检查 — 是否已经兑换过（一码只能用一次）、有没有复制到空格、是否在主站登录了正确的账号。都确认无误还失败，带着 CDK 和账号名进群找管理员
不小心关掉了显示 CDK 的页面：回到你购买/领取 CDK 的地方查记录；查不到就进群说明情况
兑换前注意：CDK 一旦兑换就绑定到当前登录的账号，兑换前先确认登录的是你自己的账号

02 文档说明与地址速查

用途	地址
主站（注册 / 钱包 / 令牌）	https://api.1110.fyi
备用站	https://api2.1110.fyi
模型与价格	https://api.1110.fyi/pricing
OpenAI 兼容接口地址	https://api.1110.fyi/v1
Anthropic 接口地址（Claude Code 用）	https://api.1110.fyi
备用接口地址	把上面地址的 api 换成 api2 即可

本站支持 GPT、Claude、DeepSeek 三个系列共 16 个模型，人民币计价，按量扣费。支持 Windows、macOS、Linux 全平台客户端。

先记住一个最核心的区别，后面所有配置都围绕它：

OpenAI 兼容类工具（Codex、Cherry Studio、Chatbox 等）：接口地址要带 /v1
Claude Code 类工具（Anthropic 协议）：接口地址用根域名，不带 /v1

填错这一步是新手最常见的报错来源。

03 快速开始（5 分钟）

打开主站注册并登录，完成邮箱验证
「钱包」里兑换你的 CDK，确认余额到账
打开「API 密钥」→「新建令牌」：起个名字、选分组、额度可先不限制 → 保存
复制完整的 sk-... 令牌（只在创建时完整显示，务必当场保存好）
按你用的工具跳到对应章节填入地址和令牌：
命令行编程：Codex（第 09 章）/ Claude Code（第 10 章），推荐先用 CC Switch 一键配置（第 08 章）
聊天客户端：Cherry Studio / Chatbox（第 11 章）
编辑器：VS Code / Cursor（第 12 章）
自己写代码调用：开发者接入（第 13 章）

04 API 密钥、分组与计费（先看懂这章，能少踩 90% 的坑）

一句话：你花多少钱，取决于「用哪个模型 × 令牌在哪个分组 × 用了多少 token」。

四个核心概念

API 密钥（令牌）：你的调用凭证，sk- 开头。它本身不是钱，只负责证明“这是你在调用”
分组：令牌创建时选定。分组决定两件事 — 这个令牌能用哪些模型、按什么倍率计费
余额：你钱包里的人民币额度，所有令牌共用，按量实时扣费；余额不用不会消失
token：计费单位，模型处理文字的计数单位（大致 1 个汉字 ≈ 1~2 个 token）。输入（你发的）和输出（模型回的）分别计价，输出通常比输入贵

费用怎么算（带算例）

费用 = 模型基础价 × 分组倍率 × token 用量

以 gpt-6-sol 在 GPT 优惠组（0.1x） 为例，它的实际价格是输入 ¥0.2 / 百万 token、输出 ¥1 / 百万 token：

一次普通问答（输入 2 万、输出 2 千 token）：约 ¥0.006，不到一分钱
一次编程会话（输入 20 万、输出 1 万 token）：约 ¥0.05
其中重复的上下文（如编程工具反复发送的代码）会走缓存价，只有全价的 1/10，实际花费往往比按标价算的更低

最容易犯的三个错

把“密钥”当成“token”：密钥是钥匙，token 是计费的量，别混
令牌选错分组：比如建了 GPT 分组的令牌，却想用 Claude 模型，会直接报“模型不可用”。换分组不用新建令牌，在令牌管理里编辑原令牌、改分组即可，立即生效
只看钱包余额：令牌自己还有额度上限，钱包有钱但令牌额度用完，一样会报错（见第 14 章）

怎么核对自己的消耗

控制台「使用日志」里有每一次调用的记录：时间、模型、输入/输出 token、费用，一笔一笔可查。对费用有疑问，先在日志里找到那一笔，再带着时间进群问，能最快解决。

05 Node.js 下载（用命令行工具必看）

Codex、Claude Code 这类命令行工具都依赖 Node.js 环境，没装的先装：

Windows：到 nodejs.org 下载 LTS 版安装包（.msi），一路下一步
macOS：下载 LTS 版 .pkg 安装，或用 Homebrew：brew install node
Linux：用发行版包管理器或 NodeSource 源安装 LTS 版

装完打开终端验证（能显示版本号就是成功）：

node -v
npm -v

注意认准自己电脑的芯片：苹果 M 系列选 ARM64，Intel 选 x64，选错装不上。

06 线路与接口地址

本站有两条线路，配置方法完全一样，主线路不通时把地址换成备用线路即可：

协议	主线路	备用线路
OpenAI 兼容（带 /v1）	https://api.1110.fyi/v1	https://api2.1110.fyi/v1
Anthropic（不带 /v1）	https://api.1110.fyi	https://api2.1110.fyi

判断该用哪种：工具里让你选「OpenAI」或填 API 地址的，用带 /v1 的；Claude Code 以及明确写着 Anthropic 的，用不带 /v1 的根域名。

07 分组与模型怎么选

价格 = 模型基础价 × 分组倍率，倍率越低越便宜。各分组能用哪些模型、具体价格，在模型广场 https://api.1110.fyi/pricing 实时可查（以广场为准，教程截图和表格可能滞后）。

分组	倍率	适合谁
GPT 优惠组	0.1x	日常聊天、轻量使用，最便宜
GPT 稳定组	0.2x	编程主力使用，速度比优惠组快
GPT 企业组	0.35x	对计费透明度要求高：不带额外隐藏上下文，按你实际用量计费
Claude Kiro	0.3x	Claude 首选：响应最快、真流式输出
Claude 逆向	1.0x	Claude 备用线路
Claude Max 官号	1.2x	官方账号线路
Deepseek	0.2x	国产模型，价格极低，适合大批量任务

模型选择建议：

写代码主力：gpt-6-sol 或 claude-sonnet-5-5
便宜大碗：gpt-6-sol（优惠组）、DeepSeek 系列
难题攻坚：gpt-6-astra、claude-opus-5-5

08 CC Switch 配置（推荐，一次配好多工具）

CC Switch 是个免费的配置切换小工具，能把本站配置一键写入 Codex、Claude Code 等工具，省去手改配置文件的麻烦。

开始前准备：一个已创建好的令牌（第 03 章）、确定用哪条线路（第 06 章）。

下载安装 CC Switch（Windows / macOS / Linux 都有）
打开本站控制台，在令牌页使用「一键导入」把本站供应商配置导入 CC Switch（或在 CC Switch 里手动新建供应商，地址和令牌按第 06、03 章填）
在 CC Switch 里选中 1110 API 这条配置，勾选要写入的工具（Codex / Claude Code）
验证：大多数工具需要重启终端后生效；重新打开工具发一句话，能正常回复即成功。切换线路后同样要重启终端

09 Codex 使用说明

先说清一个误区：ChatGPT 官方客户端（网页/桌面/手机 App）不支持填第三方接口地址和 Key，不要往官方 App 里填本站的 Key，没用的。用 Codex 请走下面两种方式：

方式一：CC Switch 导入（推荐，按第 08 章操作完就能用）

方式二：手动改配置

先装好 Node.js（第 05 章）和 Codex CLI
准备环境变量 OPENAI_API_KEY = 你的令牌（sk- 开头）
编辑 ~/.codex/config.toml（Windows 在 C:\Users\你的用户名\.codex\config.toml）：

model = "gpt-6-sol"
model_provider = "api1110"

[model_providers.api1110]
name = "1110 API"
base_url = "https://api.1110.fyi/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

重新打开终端，运行 codex，发一句话验证

令牌记得选 GPT 分组创建（优惠/稳定/企业任一）。

10 Claude Code 教程

先装好 Node.js（第 05 章）
安装 Claude Code（三选一）：
官方脚本：macOS/Linux 运行 curl -fsSL https://claude.ai/install.sh | bash；Windows 用 PowerShell 官方命令
或 npm：npm install -g @anthropic-ai/claude-code
设置两个环境变量：
ANTHROPIC_BASE_URL = https://api.1110.fyi（根域名，不要带 /v1）
ANTHROPIC_AUTH_TOKEN = 你的令牌（令牌要选 Claude 分组创建，推荐 Kiro 组）
运行 claude --version 确认安装，再运行 claude 开始对话验证

Windows 用户把环境变量写进「系统设置 → 环境变量」后要重开终端才生效。

11 Cherry Studio / Chatbox 配置（聊天客户端）

以 Cherry Studio 为例，Chatbox 操作基本一致：

打开「设置 → 模型服务 → 添加服务商」，类型选 OpenAI 兼容
接口地址填 https://api.1110.fyi/v1
API 密钥粘贴你的令牌（注意前后不要带空格）
手动添加模型，名称必须和模型广场上一字不差，如 gpt-6-sol、claude-sonnet-5-5
验证：回到对话界面，顶部选中刚加的模型，发一句话测试

令牌分组决定能用哪些模型：想用 Claude 就建 Claude 分组的令牌，想用 GPT 就建 GPT 分组的令牌。一个令牌只能用自己分组内的模型，换分组编辑原令牌即可（第 04 章）。

12 VS Code 与 Cursor

VS Code

安装 VS Code，并装好中文语言包（扩展商店搜 Chinese）
安装你要用的官方 AI 插件（如 Codex / Claude Code 官方扩展）
确认 CC Switch 正在运行且已选中 1110 API 线路（插件读取的是同一份配置，按第 08 章配好即可）
打开插件面板，选模型发消息验证
Linux 用户同样适用，配置文件路径与 macOS 一致

找不到插件时先确认 VS Code 是最新版，并检查插件是否被禁用。

Cursor

打开 Cursor「设置 → Models」
在 OpenAI API Key 处填你的令牌，并把 Override OpenAI Base URL 设为 https://api.1110.fyi/v1
添加并选用模型（名称与模型广场一致）
注意：Cursor 的个别内置功能仍会调用官方模型、可能不可用，这是 Cursor 的机制，属正常现象；核心补全与对话走本站线路

13 开发者接入（自己写代码调用）

本站完全兼容 OpenAI 接口规范，原来用 OpenAI SDK 的代码只需要改两个地方：把 base_url 换成 https://api.1110.fyi/v1，api_key 换成你的令牌，其他代码不用动。

先用 curl 最小验证（任何客户端接不通时，先跑这条确认账号和线路没问题）

curl https://api.1110.fyi/v1/chat/completions \
  -H "Authorization: Bearer 你的令牌" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-6-sol", "messages": [{"role": "user", "content": "你好"}]}'

能返回一段 JSON 回复，说明key、线路、分组都通。curl 都不通就不要先怀疑客户端配置，按第 14 章排查。

Python SDK

from openai import OpenAI

client = OpenAI(
    base_url="https://api.1110.fyi/v1",
    api_key="你的令牌",
)
resp = client.chat.completions.create(
    model="gpt-6-sol",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js SDK

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.1110.fyi/v1",
  apiKey: "你的令牌",
});
const resp = await client.chat.completions.create({
  model: "gpt-6-sol",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

Claude 原生接口：走 Anthropic Messages 格式时，地址用根域名 https://api.1110.fyi，请求 POST /v1/messages，鉴权用 x-api-key 头（不是 Bearer），并带 anthropic-version: 2023-06-01。新项目更推荐直接用上面的 OpenAI 兼容方式，省事。

14 常见报错排查

先走万能排查清单（按顺序，多数问题在前三步解决）

用第 13 章的 curl 命令测一下：通 → 问题在客户端配置；不通 → 看返回的错误码对表
查钱：钱包余额 + 令牌额度，两层都要看
查分组：令牌的分组里有没有你调的模型（模型广场可查）
查地址：该带 /v1 的带了吗？Claude Code 是不是误带了 /v1？
换线路：把 api 换成 api2 再试
还不行 → 带着信息进售后群（清单在本章末尾）

按错误码对表

错误码	含义	怎么办
400	请求格式不对	检查模型名拼写、参数是否超限（如上下文太长）
401	密钥错误	令牌复制不全/多了空格/已被删或禁用；回「API 密钥」页核对，必要时新建；泄露过立即删除重建
402 / 余额不足	没钱了	查钱包余额和令牌额度两层（见下）
403	无权限	常见于令牌分组与模型不匹配，或 IP 限制；核对分组设置
404	地址错误	九成是 /v1 填错，按第 06 章对照改
413	请求内容过大	开新会话、减少粘贴内容、调低上下文上限
429	请求太频繁	降并发、稍等重试；多人共用一个令牌时容易触发
500 / 502 / 503	上游或服务端异常	等几分钟重试，或换备用线路 api2；持续出现进群反馈
504 / 524	超时	长任务容易遇到：开流式输出、拆小任务、换线路重试

几个高频问题

模型不可用 / 当前分组没有可用渠道：令牌分组里没有这个模型。到模型广场查该模型属于哪个分组，编辑令牌改分组或新建对应分组的令牌
余额不足（两层限制）：① 账号钱包余额；② 令牌自身的额度上限。任一耗尽都会报错，去钱包和令牌页分别确认
命令找不到（node / npm / claude / codex）：Node.js 没装或没写进 PATH。按第 05 章重装 LTS 版，装完重开终端再试
连接超时 / Failed to fetch：先刷新重试；还不行切换到备用线路 api2；公司/校园网可能拦截，换个网络试试
回复很慢或等很久才出字：长回答本身需要时间；不同线路速度有差异，Claude 推荐 Kiro 组（真流式、出字最快），GPT 推荐稳定组。个别分组是整段返回的，文字会一次性出现，不是卡死
扣费和我发的字数对不上：编程类工具会在后台附带较长的上下文（代码文件、历史对话），都会计入输入 token，属正常计费；在「使用日志」里能看到每一笔的明细。对透明度敏感可选 GPT 企业组
ChatGPT 官方 App 无法登录或填不了 Key：正常现象，官方客户端不支持第三方 Key，改用 Codex CLI、Cherry Studio、Chatbox 等支持自定义接口的工具（第 09、11 章）

联系售后时，请带上这些信息（处理最快）

你的账号名（不要发完整令牌！）
出错的大概时间
用的模型和分组
报错截图或错误码原文
在哪个工具里用的、接口地址填的什么

15 售后支持

教程里没解决的问题、购买 CDK、额度异常，都可以进官方 QQ 群找管理员：

群名：1110技术交流群
群号：122750534
扫码进群：

进群后请先说明你的问题和账号名（带上第 14 章末尾那份信息清单，处理最快）。令牌（sk- 开头）属于你的个人密钥，不要发到群里，售后不会向你索要完整令牌。

教程版本：2026-10-21（v2）。模型与价格以模型广场实时页面为准：https://api.1110.fyi/pricing