客户端接入指南

Pi

为 Pi coding agent 配置自定义服务商。

可接入

在 Pi 中使用 Inferway 聊天和处理代码任务。接入前，请确认账户已开通模型访问。

当前 Inferway 模型配置参数

推荐模型deepseek/deepseek-v4.1-flash-1017

上下文窗口1,048,576

示例输出上限262,144

本客户端尚无针对 deepseek/deepseek-v4.1-flash-1017 的验证记录；以下配置仅供参考。

开始之前

先按官方说明安装客户端。本文的 Pi 指 pi-mono coding agent；Hermes 指 Nous Research 的 Hermes Agent。

账户开通后，在控制台的「API 密钥」页创建密钥。建议给这个客户端单独建一把；花费上限可以用项目的月度预算来控制。live 和 test 两种前缀走的是同一套推理和计费流程，test 只是环境标签，不代表免费，也不是模拟推理。

Inferway 地址需要 Inferway Key；OpenRouter Key 用于 OpenRouter，不能直接用于此地址。

将 Key 保存在客户端凭证存储或本机环境中，不要粘贴到提示词、截图或提交到仓库的配置文件。终端示例适用于 macOS / Linux 的 bash、zsh。

在当前终端设置 Key

下面的交互输入会隐藏 Key，并避免将其写入命令历史。请从同一个终端启动客户端；另外打开的应用可能无法继承该变量。

INFERWAY_API_KEYbash

printf 'Inferway API key: '
IFS= read -r -s INFERWAY_API_KEY
printf '\n'
export INFERWAY_API_KEY

确认地址和模型

使用完整模型 ID deepseek/deepseek-v4.1-flash-1017。Base URL 只包含一次 /v1，不要在 Base URL 设置中添加 /chat/completions。确认下方响应中包含该模型 ID。

列出模型bash

curl --fail-with-body --silent --show-error --max-time 30 \
  'https://api.inferway.ai/v1/models' \
  -H "Authorization: Bearer $INFERWAY_API_KEY"

添加自定义服务商

将以下服务商合并到 ~/.pi/agent/models.json；若文件已存在，保留原有服务商。Pi 的 openai-completions 适配器使用 Chat Completions，并不是旧的 /completions 接口。

Pi 通过 $INFERWAY_API_KEY 中的美元符号识别环境变量。若仍使用旧 Key，检查 Pi 的 auth.json 是否保存了 inferway 凭证。本示例只使用文本，关闭思考和图片；验证模型与客户端行为后再启用。

~/.pi/agent/models.jsonjson

{
  "providers": {
    "inferway": {
      "baseUrl": "https://api.inferway.ai/v1",
      "api": "openai-completions",
      "apiKey": "$INFERWAY_API_KEY",
      "models": [
        {
          "id": "deepseek/deepseek-v4.1-flash-1017",
          "name": "Inferway",
          "reasoning": false,
          "input": [
            "text"
          ],
          "contextWindow": 1048576,
          "maxTokens": 262144,
          "compat": {
            "supportsDeveloperRole": false,
            "supportsReasoningEffort": false,
            "maxTokensField": "max_tokens"
          }
        }
      ]
    }
  }
}

选择 Inferway

使用下面的命令明确选择服务商和模型，或在 Pi 中输入 /model 选择 Inferway。/model 会重新加载模型配置；模型不显示时先检查 INFERWAY_API_KEY 是否已设置。

Pibash

pi --provider inferway --model 'deepseek/deepseek-v4.1-flash-1017'

免费账户与长任务

注册免费账户：突发 8 次/秒、每分钟 90 次、每小时 500 次，并发 4。试玩模型每天最多 200 万 tokens（输入与输出合计，UTC 0 点即北京时间 8 点重置）。不限制单次输入或输出 token。

每小时的次数按滚动窗口计算，不在固定时刻整体重置。同一账户的 API Key 共享这些次数额度。

单次请求仍受模型自身的上下文长度和最大输出限制。超过 4,096 tokens 的输出请使用流式请求。

Pi 使用流式响应。非交互任务请将标准输入重定向到 /dev/null。若提示单次请求过大，请压缩对话；等待不会改变单次限制。

执行任务bash

pi --provider inferway --model 'deepseek/deepseek-v4.1-flash-1017' -p 'Review this project and run its tests' </dev/null

确认接入成功

使用配置的服务商和模型开启新会话，发送“只回复：连接成功”，确认收到文本且没有 API 错误。
打开控制台的「请求」页，查看请求状态和 Token 用量。
处理代码任务时，让客户端读取一个非敏感文件。应用修改前，请先检查它提出的改动。

费用与用量

实际用量由 Inferway 记录：控制台的「请求」页能看到每次请求的状态和 Token 用量，「用量」页是汇总。客户端本地显示的数字只是它自己的估算，不是实际扣费，一切以控制台为准。

验证状态

该模型在本客户端尚无验证记录：以下配置仅供参考，不构成针对该模型的已验证接入。

请求失败时

认证失败：检查 Key 是否存在、有效且获准使用该模型，并从设置变量的终端重新打开客户端。排错时不要输出完整 Key。

地址或模型错误：检查是否重复添加 /v1，使用公布的完整模型 ID，并确认客户端选择 Chat Completions。请求发往 /responses 或 /completions 时，换 Key 无法解决。

额度或超时：检查钱包余额和 Key 限额，按 Retry-After 等待，并缩短输入或降低输出上限。长输出保持流式传输，排错期间避免 Agent 连续重试。

联系支持时提供客户端版本、模型 ID、请求时间和可用的 request ID；请遮盖凭证和源码。

官方文档（英文）

Pi · Custom models