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. 开源项目与部署

Pi Coding Agent 配置 4sAPI

访问地址:国内推荐 https://4sapi.org,海外使用 https://4sapi.top;专线、北美等完整说明见 《国内外直连域名》。
配置速查
配置项填写内容
Base URLhttps://4sapi.org;OpenAI 兼容接口填 https://4sapi.org/v1
API Key控制台 → 令牌管理 创建的令牌,形如 sk-...
模型名称与控制台【模型广场】完全一致;不同令牌分组可用的模型不同

一、安装 Pi#

打开 Pi 官网,点击 Copy 复制安装命令。
启动 PowerShell,粘贴并执行安装命令,然后按照终端提示完成安装。
image.png

二、验证安装#

安装完成后,打开一个新的 PowerShell 窗口,执行以下命令:
pi -v
终端显示 Pi 版本号,即表示安装成功。
image-1.png

三、配置 4SAPI#

找到以下目录,将 [你的电脑用户名] 替换为当前 Windows 用户名:
C:\Users\[你的电脑用户名]\.pi\agent
如果目录不存在,请先创建目录。然后在该目录下新建 models.json 文件,并填入以下配置:
image-2.png
{
  "providers": {
    "4sapi": {
      "name": "4s API",
      "baseUrl": "https://4sapi.org/v1",
      "apiKey": "sk-****",
      "api": "openai-completions",
      "models": [
        {
          "id": "gpt-5.6-sol",
          "name": "gpt-5.6-sol",
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 128000
        },
        {
          "id": "claude-opus-5",
          "name": "claude-opus-5",
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 128000
        },
        {
          "id": "claude-opus-4-7",
          "name": "claude-opus-4-7",
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 128000
        }
      ]
    }
  }
}
配置时请注意:
处于国内网络,URL改成下面其中之一(url末尾加上 /v1):

四、选择模型并开始对话#

保存 models.json 后,打开 PowerShell,执行:
pi
进入 Pi CLI 后,输入 /model 并按回车。选择刚刚配置的 4SAPI 模型,再按回车即可开始对话。
image-4.png
image-3.png
image-5.png

更新于 2026-11 官方文档:https://pi.dev/
修改于 2026-11-05 03:35:55
上一页
DeepSeek Harness 接入 4sAPI
下一页
OpenClaw 接入 4sAPI
Built with