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. 快速开始

令牌管理使用指南

访问地址:国内 https://4sapi.org、https://4stoken.com;海外 https://4sapi.top、https://4sapi.com、https://us.4sapi.com;纯 API 专线 https://4sapi.ai;北美低延迟 https://4sapi.net。详见《国内外直连域名》。
令牌是调用 4SAPI 大模型服务的身份凭证。通过 控制台 → 令牌管理,可以创建令牌,并对令牌进行复制、额度调整、分组、分类、筛选、统计和删除等操作。
请妥善保管令牌密钥,不要在公开场合或不可信的平台中展示。若令牌疑似泄露,请及时禁用或删除,并创建新令牌。

一、添加令牌#

1.
登录 4SAPI,进入 控制台。
2.
在左侧导航栏中选择 令牌管理。
3.
点击 添加令牌。
image.png
在 创建新的令牌 页面中填写或选择以下信息:
名称:输入便于识别的令牌名称。
令牌分组:选择令牌所属的模型分组。
过期时间:设置令牌的有效期,也可以选择 永不过期。
额度设置:填写可用额度,或开启 无限额度。如有需要,还可以设置额度重置周期。
模型限制列表:可限制令牌能够调用的模型;非必要时建议留空。
IP 白名单:可限制允许使用令牌的 IP 地址;非必要时建议留空。
确认配置无误后,点击 提交。
image.png

二、保存令牌(重要❗️)#

创建后的 key 只显示一次,点击图中箭头指向的复制按钮即可复制 key,请妥善保管好。
image.png
遗忘或者丢失 key 则需要通过重置 key 来获取新的 key。
image.png
成功后,新令牌会显示在令牌列表中。列表中可以查看令牌状态、剩余额度、所属分组、分类、密钥、可用模型、IP 限制及有效期等信息。
image.png

三、批量修改额度#

1.
勾选需要调整额度的一个或多个令牌。
2.
点击 批量修改额度。
image.png
输入新的可用额度,或开启 无限额度,然后点击 应用到所选令牌。如需重新开始计算额度,可先点击 额度重置。
下图示例将两个令牌的额度统一设置为 ¥40。
image.png
修改成功后,可以在 剩余额度/总额度/已用 一栏查看新额度。
image.png

四、批量修改令牌的分组#

令牌分组决定令牌使用的模型渠道及对应倍率。修改前,请确认目标分组符合实际调用需求。
1.
勾选需要调整分组的一个或多个令牌。
2.
点击 批量修改分组。
image.png
在下拉列表中选择目标分组,然后点击 确定。
image.png
修改成功后,可以在令牌列表的 分组 一栏查看新分组。
image.png

五、创建并设置分类#

分类用于整理令牌,不会改变令牌所属的模型分组。首次使用分类功能时,需要先创建分类。

1. 创建分类#

点击 批量分类设置
image.png
然后在弹出的 设置分类 窗口中点击 添加
image.png
输入分类名称,点击 添加,确认分类出现在列表中后点击 X号 关闭窗口
image.png
image.png

2. 为令牌设置分类#

1.
勾选需要分类的一个或多个令牌。
2.
再次点击 批量分类设置。
image.png
在分类下拉列表中选择刚创建的分类,然后点击 应用到所选令牌。
image.png
设置成功后,可以在令牌列表的 分类 一栏查看分类标签。
image.png

六、分类功能 展示令牌#

当令牌数量较多时,可以使用 筛选分类 快速定位指定分类下的令牌。
点击 筛选分类,从下拉列表中选择目标分类。
选择后,列表仅显示该分类下的令牌。需要恢复全部令牌时,可重新选择其他筛选项或重置筛选条件。
image.png

七、查看使用统计#

点击令牌列表上方的 使用统计,可以按月份查看各令牌每日的使用情况及合计数据。
该页面还支持按令牌名称搜索、切换月份和导出报表。
image.png

八、批量删除令牌#

1.
勾选需要删除的一个或多个令牌。
2.
点击 删除所选令牌。
3.
按页面提示确认删除。
image.png
删除后,使用这些令牌的客户端将无法继续调用服务。删除操作前,请确认相关令牌已不再使用,并及时更新对应的客户端配置。
修改于 2026-11-05 07:12:56
上一页
价格、充值与分组说明
下一页
客户端怎么选:会直接影响你的账单
Built with