PiAgent 接入 kkaiapi
最后更新: 2026-06-23
在 PiAgent 中配置 kkaiapi Base URL、API Key 和模型 ID，用同一个入口调用 Claude、GPT、Gemini、DeepSeek 与国产模型。
| 关键词 | PiAgent API 配置 |
|---|---|
| 适用对象 | 工具/Agent 用户 |
| Base URL | https://api.kkaiapi.com/v1 |
| 计费方式 | 按量计费，余额按实际调用扣减 |
| 相关词 | PiAgent Base URL、PiAgent 自定义模型、PiAgent AI API |
需要填写的核心配置
大多数工具只需要三项：Base URL、API Key、模型 ID。Base URL 填 https://api.kkaiapi.com/v1，不要填到 /v1/chat/completions 这样的具体 endpoint；模型 ID 从模型页复制，避免大小写或符号错误。
- 一个 API Key 覆盖多模型，减少多家上游账号切换。
- 中文价格页和模型页可直接复制 Base URL 与模型 ID。
- 控制台能查看余额、调用日志、错误信息和 token 消耗。
OpenAI SDK 示例
如果你的工具支持 OpenAI-compatible provider，通常不需要改业务代码，只要换 Base URL、API Key 和模型 ID。
from openai import OpenAI
client = OpenAI(
api_key="sk-...",
base_url="https://api.kkaiapi.com/v1",
)
response = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[{"role": "user", "content": "用一句话确认连接成功"}],
)
print(response.choices[0].message.content)常见配置错误
最常见的问题是把完整 endpoint 填进 Base URL、模型 ID 多了空格、Key 属于另一个账号，或者工具要求的协议和模型能力不匹配。先用模型页复制 ID，再用控制台调用日志确认真实错误。
常见问题
PiAgent 接入 kkaiapi 要填哪个 Base URL？
填写 https://api.kkaiapi.com/v1。不要把 /v1/chat/completions、/v1/messages 或 /v1/images/generations 这类 endpoint 填进 Base URL。
一个 kkaiapi API Key 可以调用多个模型吗？
可以。只要模型已上架且 Key 未被限制，同一个 Key 可以在 Claude、GPT、Gemini、DeepSeek、Kimi、Qwen、GLM 和图像模型之间切换。
调用失败后在哪里看原因？
登录控制台查看 API 调用日志。日志会显示模型、状态、token、扣费和脱敏后的错误信息。