1. 快速开始
4sapi文档
  • 站点操作指南-快速上手调用大模型API(必看!!!!)
  • 快速开始
    • 国内外直连域名
    • 价格、充值与分组说明
    • 令牌管理使用指南
    • 客户端怎么选:会直接影响你的账单
  • 接入教程
    • IDE 与 AI 编程助手
      • Claude Code CLI 安装与配置 4sAPI(Windows + CC Switch)
      • Claude Code CLI 安装与配置 4sAPI(Windows / macOS / Linux)
      • Trae 配置指南(插件)
      • Gemini CLI 配置指南
      • Cursor 配置指南
      • VS Code 配置指南
      • ChatGPT(Codex)CLI 安装与配置 4sAPI
      • MiMoCode CLI 安装与配置 4sAPI
      • OpenCode CLI 配置指南(CC Switch)
      • Kilo Code 配置指南
    • 桌面客户端
      • Claude Code 桌面端安装与配置 4sAPI
      • ChatGPT(Codex)桌面端安装与配置 4sAPI
      • Hermes Agent 桌面端安装与配置 4sAPI
      • OpenCode 桌面端配置指南
      • ChatBox 接入 4sAPI 教程
      • CherryStudio 接入 4sAPI 教程
      • WorkBuddy 接入 4sAPI 教程
    • 工作流与自动化
      • CC Switch 安装与配置教程
      • CC Switch 导入 4sAPI 令牌(API Key)
      • Claude Code + CC Switch 配置 DeepSeek / GLM 模型
      • n8n 配置使用 4sAPI
      • Dify 配置使用 4sAPI
      • Coze 配置使用 4sAPI
    • 开源项目与部署
      • DeepSeek Harness 接入 4sAPI
      • Pi Coding Agent 配置 4sAPI
      • OpenClaw 接入 4sAPI
      • OpenClaw Web 界面配置 4sAPI
      • OpenClaw Linux 服务器终端配置 4sAPI
      • Hermes Agent Linux 安装接入 4sAPI
      • Hermes Agent CLI 安装与配置 4sAPI(CC Switch)
      • 腾讯云 OpenClaw 接入 4sAPI:配置 QQ 机器人
  • 模型接口
    • OpenAI
      • 文本模型
        • 文本生成
        • 上下文阅读
        • PDF文件分析
        • 联网搜索 Web Search
        • 函数调用 tools
        • Response_Format
        • v1/Responses / 通用
      • 图像模型
        • 图片理解(多模态视觉分析)
        • 图片生成(统一接口 · 支持多模型)
        • 图像编辑(统一接口 · 表单上传 / JSON 双模式)
      • Embedding 模型
        • 创建文本嵌入
        • 批量创建嵌入
    • Anthropic Claude
      • 原生接口
        • 思考强度
        • 文本生成 (思考配置)
        • 图片理解(原生)
        • 文本生成(原生)
        • 文本生成 / 强制返回思考(原生)
        • 函数调用(原生)
        • Web search / 联网搜索(原生)
      • OpenAI兼容接口
        • 文本生成(OpenAI兼容)
        • 图片理解(OpenAI兼容)
        • 文本生成 / 强制返回思考(OpenAI兼容)
        • 函数调用(OpenAI兼容)
        • Web search / 联网搜索(OpenAI兼容)
    • Google Gemini
      • OpenAI兼容接口(推荐)
        • 文本生成(OpenAI兼容)
        • 文本生成 / 强制返回思考(OpenAI兼容)
        • 图片生成
        • 图片理解(OpenAI兼容)
        • 图片理解(base64格式)
        • 图片编辑
        • 图片编辑(base64格式)
        • 音频理解
        • 视频理解
        • 文本转语音 / TTS
      • Google Gemini接口
        • 文本生成(Gemini原生)
        • 文字转语音
        • 音频转文
        • 视频转文
        • 图片理解(Gemini原生)
        • 文生图片(NanoBanana Pro)
        • 图片编辑(NanoBanana)
        • 图片编辑(NanoBanana Pro)
      • Omni 视频生成
        • 创建视频任务
        • 创建视频任务
        • 轮询任务状态
        • 下载 MP4
    • xAI Grok
      • Responses 原生接口
        • 简单对话
        • 对话历史
        • 流式输出
        • 联网搜索
        • 联网搜索(域名过滤)
        • 联网搜索(图片选项)
      • Chat Completions 接口
        • 文本对话
        • 多轮对话
        • 流式输出
        • 工具调用
        • 图片理解
      • 图像模型接口
        • 生成图片(URL 方式)
        • 生成图片(Base64 方式)
        • 批量生成
        • 自定义比例 / 分辨率 / 质量
      • 获取模型列表
    • DeepSeek
      • Chat Completions 接口
        • Chat Completions API
        • 思考模式
        • 工具调用
        • 流式输出
      • Response 接口
        • Response API
        • 思考模式
        • 工具调用
        • 流式输出
    • 通义千问 Qwen
      • Chat Completions 接口
        • 文本对话
        • 流式输出
        • 工具调用
        • 视频输入
        • 图像输入
        • 联网搜索
      • Messages 接口
        • 文本对话
        • 流式输出
        • 深度思考
        • 图片理解
        • 视频理解
        • 工具调用
      • 图像生成
        • 生成图片
      • 视频生成
        • 创建视频任务
        • 查询视频任务
        • 下载视频
    • 智谱 GLM
      • Chat Completions 接口
        • 文本对话
        • 流式输出
        • 工具调用
        • 联网搜索
      • Messages 接口
        • 文本对话
        • 流式输出
        • 深度思考
        • 工具调用
    • 月之暗面 Kimi
      • Chat Completions 接口
        • 简单对话
        • 推理对话
        • 流式输出
        • 图片输入
        • 视频输入
        • 工具调用
    • MiniMax
      • Chat Completions 接口
        • Chat Completions API
        • 图片理解
        • 视频理解
        • 深度思考
        • 流式输出
        • 工具调用
      • Responses 接口
        • Responses API
        • 简单对话
        • 对话历史
        • 流式输出
        • 工具调用
        • 多轮工具调用
      • Anthropic 接口
        • Anthropic API
        • 图片理解
        • 视频理解
        • 深度思考
        • 流式输出
        • 工具调用
    • 腾讯混元 Hunyuan
      • chat completions 接口
        • 简单对话
        • 流式请求
        • 深度思考
        • 多轮对话
        • 工具调用
    • Muse
      • Chat Completions 接口
        • Muse Chat Completions 接口
      • Messages 接口
        • Muse Messages 接口
      • 图像模型接口
        • 生成图片
        • 编辑图片
      • 模型目录
        • 获取当前令牌可用模型
  • 平台接口
    • 获取系统访问令牌(Authorization / Access-Token)指南
    • 用户信息管理
      • 获取用户可使用的模型
      • 注销当前用户
      • 获取用户可用的模型分组信息
      • 获取当前用户可用的模型分组信息
      • 获取当前用户信息
      • 更新当前用户信息
      • 更新用户设置(额度预警等)
      • 重置并生成新系统访问令牌
    • 令牌管理(API Key)
      • 获取全部令牌的信息
      • 获取指定令牌的信息
      • 获取指定令牌的使用情况
      • 搜索令牌
      • 创建令牌
      • 更新令牌
      • 删除令牌
      • 批量删除令牌
    • 用户登录注册
      • 发送密码重置邮件
      • 用户登录
      • 用户登出
    • 用户任务管理
      • 获取个人Midjourney任务
      • 获取个人任务
    • 日志与数据统计
      • 获取个人调用后具体的日志信息
      • 获取指定时间段调用模型的数据
      • 个人日志消费统计
      • 获取令牌总消耗
      • 获取令牌累计消耗前三的模型
      • 获取令牌中各个模型的总消耗
      • 导出令牌消耗数据(XLSX格式)
    • 获取系统信息
      • 获取首页内容
      • 获取通知公告
      • 获取系统状态
    • 兑换码接口
      • 使用兑换码
    • 充值接口
      • 获取充值信息
      • 获取用户充值记录
    • 其他
      • 删除Passkey
      • 获取Passkey状态
      • 开始注册Passkey
      • 完成注册Passkey
      • 开始验证Passkey
      • 完成验证Passkey
  • 常见问题
    • 问题自查方法
    • 入门必看
      • 如何在 4sAPI 充值?
      • 可以使用哪些 大模型API ?
      • 如何获取 OpenAI Key ? 如何获取 Claude Key ? 如何获取 Gemini Key ?等等
      • 我注册并且充值了,key 在哪?
      • 怎么更换模型使用?
      • 配置模型的时候 URL 用哪个?
      • 接口在中国大陆能使用吗?
      • 按量计费还是按月支付?
      • 使用日志在哪里?怎么看一次调用消耗了多少 Token?
      • 请问我余额为负了怎么回事?
    • 常见误区
      • 明明余额还有很多,为什么显示令牌无法使用?
      • Key 为什么不能用?为什么我调用 API 没反应?
      • 新建令牌参数怎么填?
      • 为什么调用接口返回“无效的令牌”?
      • API 接口返回报错,报错代码 400 401 403 404 405 413 429 500 503 504 524 是什么意思?
    • Claude Code 报错排查
      • Claude-官方和企业推荐全模型分组claude模型在claude code中使用报错 400处理方法
  • 数据模型
    • ChatCompletionRequest
    • Error
    • EditImageItem
    • GenericJsonObject
    • ImagesResponse
    • ImageEditJsonRequest
    • ImageGenerationRequest
    • ImageEditMultipartRequest
    • Message
    • ModelObject
    • ModelsResponse
    • MessagesRequest
    • MetaMuseTextModel
    • MetaMuseImageModel
    • ReasoningEffort
    • ToolEnablement
  1. 快速开始

客户端怎么选:会直接影响你的账单

先说结论#

你用哪个模型用什么客户端
Claude 系列Claude Code CLI
GPT 系列Codex CLI
只是偶尔问几句随便,桌面客户端都行
长对话、读大文件、一挂就是几小时用上面两个官方 CLI
同样是 10 万 token 的内容,换个客户端发,账单可能差 5 倍。

为什么差这么多#

模型有个省钱机制:如果你这次发的内容开头和上次一样,它直接复用上次算好的结果,这部分只收零头;开头一变,就得从头再算,这部分比正常输入还贵。
很多桌面客户端为了控制对话长度,每次发送前会自动整理历史——丢掉旧消息、生成一段摘要、把工具返回的结果截断。对聊天体验没影响,但对缓存是致命的:开头动一个字,前面全白算。
我们统计过一个真实案例(GPT 模型):同一个模型、同样多的请求,用 Chatbox 的用户缓存命中率 7.8%,用 Codex CLI 的是 91%。一笔 34 万 token 的请求,一个收 21 元,一个收 0.69 元。Claude 模型的价格不同,具体金额对不上,但缓存一断就贵很多,这一点是一样的。

还有个容易忽略的点:接哪个接口#

同一个客户端,接 Claude 原生接口和接 OpenAI 兼容接口,结果也不一样:
你接的接口谁能控制缓存
Claude 原生(/v1/messages)客户端,好的客户端会帮你优化
OpenAI 兼容(/v1/chat/completions)平台,客户端插不上手
我们统计了 3 小时内 613 次 Claude 请求:走原生接口的只有 2.1% 没吃到缓存,走兼容接口的是 17.8%,差 8 倍。
所以配客户端时先看它支持哪种协议——能用 Claude 原生协议,就别用 OpenAI 兼容。

分三档#

第一档:官方 CLI,最省钱#

Claude Code CLI(Claude 系列首选)
Claude 官方客户端,缓存由它自己管,最不容易失效
长对话、读代码库、连续多轮都适合
配置见站内《Claude Code CLI 安装与配置 4sAPI》
Codex CLI(GPT 系列首选)
OpenAI 官方客户端,实测缓存命中 90% 以上
配置见站内《ChatGPT(Codex) CLI 安装与配置 4sAPI》
如果是长时间挂着干活,优先选这两个。

第二档:能用,注意几件事#

Cursor、VS Code 插件(Cline、Roo Code 等)
用新模型时可能不发思考参数,效果打折扣,建议手动添加模型
建议优先选 Anthropic 协议,别用 OpenAI 兼容
Cherry Studio
用 Claude 模型时它做了缓存优化,表现比多数桌面客户端好
但只在 Anthropic 协议下有效,兼容模式就靠平台了
协议类型别选「OpenAI-Response」,多一层转换,出问题不好查
Claude 模型的 API 主机填 https://4sapi.org(不带 /v1)
OpenClaw
默认把最新变动的内容放最前面,缓存容易整段作废
10 月有用户因此单次费用涨了约 10 倍
建议把变动内容放末尾,长任务定期另开会话

第三档:长任务别用#

Chatbox
它每次发送前会整理历史,有三处会动到开头:
1.
消息超过上限时,整块丢掉较早的
2.
内容太长时生成一次摘要,每次都不一样
3.
工具结果超过 1500 字会被截断
只要中一条,前面的缓存全部作废,按更贵的缓存写入重新计价。
已经在用的话,这样降费用:
一个对话里别连着读多个大文件
读完一批就另开会话
别点「重试」,重试等于整段重写一遍
设置里把历史消息条数调大,减少丢弃

一句话#

便宜的用法不是找折扣,是让缓存别断。同样的模型、同样的内容,换个客户端,账单可能差几倍。
修改于 2026-11-05 03:12:29
上一页
令牌管理使用指南
下一页
Claude Code CLI 安装与配置 4sAPI(Windows + CC Switch)
Built with