Piaxi CodingPlan 文档
私有 AI 中转站，让模型接入更简单。Piaxi CodingPlan 将多组模型能力整理成一个 OpenAI 兼容入口。你只需要配置 Base URL 和 API Key，就可以在支持 OpenAI 协议的工具、SDK 与工作流里直接调用。
首次调用 API
把 Base URL 设置为 https://coding.piaxi.fun/v1，使用控制台创建的 API Key 作为 Bearer Token。下面的请求会让模型返回一个很短的 ok。
curl https://coding.piaxi.fun/v1/chat/completions \
-H "Authorization: Bearer $PIAXI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen3.7-max",
"messages": [
{ "role": "user", "content": "Reply with exactly: ok" }
],
"stream": false
}'创建或复制 API Key
在控制台的 API Keys 页面创建密钥。页面不会展示真实测试密钥，请在自己的环境变量中保存。
选择模型名称
直接使用下方模型列表里的名称，例如 deepseek-v4-pro、kimi-k2.7-code 或 qwen3.7-max。
保持 OpenAI 协议
如果你的客户端支持自定义 Base URL，通常只需要替换 Base URL 和 Key，业务代码可以继续沿用 OpenAI SDK。
鉴权方式
所有 OpenAI 兼容接口都使用 HTTP Bearer Token。不要把密钥提交到仓库，也不要放进前端页面。
Authorization: Bearer sk-your-api-key
Content-Type: application/json推荐在服务端环境变量中保存 API Key，例如 PIAXI_API_KEY。如果密钥泄露，请立即在控制台禁用并重新创建。
套餐与额度
每个 API Key 会归属到对应订阅分组。额度与可见模型以控制台实际配置为准，适合从轻量个人调用一路扩展到高频开发工作流。
| 套餐 | 价格 | 月额度 | 模型数 | 适用场景 |
|---|---|---|---|---|
| Lite 轻量 | 29.9 元/月 | 60 USD | 26 | 个人日常问答、少量 coding 辅助和工具接入验证。 |
| Pro 推荐 | 79.9 元/月 | 195 USD | 26 | 稳定高频的 coding、代理工具和多客户端使用。 |
| Max 高额度 | 149.9 元/月 | 390 USD | 26 | 长上下文、重度 agent 工作流和更高并发的团队使用。 |
| Max10x 10x 高额度 | 249.9 元/月 | 650 USD | 26 | 更高用量密度的重度 agent、批量 coding 和高频自动化。 |
四个订阅档位当前开放同一组模型；差异主要体现在月额度和适用的使用强度。
模型列表
你可以通过 GET /v1/models 获取当前 API Key 所属套餐可见的模型。下面按每 1M tokens 的 USD 价格列出当前模型 ID、适用套餐和输入/输出/缓存价格。
curl https://coding.piaxi.fun/v1/models \
-H "Authorization: Bearer $PIAXI_API_KEY"| 模型 ID | 适用套餐 | 输入 | 输出 | 缓存读取 | 缓存写入 |
|---|---|---|---|---|---|
deepseek-v4-flash |
Lite / Pro / Max / Max10x | $0.14 | $0.28 | $0.0028 | - |
deepseek-v4-pro |
Lite / Pro / Max / Max10x | $1.74 | $3.48 | $0.0145 | - |
glm-5 |
Lite / Pro / Max / Max10x | $1.40 | $4.40 | $0.26 | - |
glm-5.1 |
Lite / Pro / Max / Max10x | $1.40 | $4.40 | $0.26 | - |
glm-5.2 |
Lite / Pro / Max / Max10x | $1.40 | $4.40 | $0.26 | - |
gpt-5.3-codex-spark |
Lite / Pro / Max / Max10x | $1.75 | $14.00 | $0.175 | - |
gpt-5.4 |
Lite / Pro / Max / Max10x | ≤272K $2.50>272K $5.00 | ≤272K $15.00>272K $22.50 | ≤272K $0.25>272K $0.50 | - |
gpt-5.4-mini |
Lite / Pro / Max / Max10x | $0.75 | $4.50 | $0.075 | - |
gpt-5.5 |
Lite / Pro / Max / Max10x | ≤272K $5.00>272K $10.00 | ≤272K $30.00>272K $45.00 | ≤272K $0.50>272K $1.00 | - |
gpt-image-2 |
Lite / Pro / Max / Max10x | - | - | - | - |
hy3-preview |
Lite / Pro / Max / Max10x | - | - | - | - |
kimi-k2.5 |
Lite / Pro / Max / Max10x | $0.60 | $3.00 | $0.10 | - |
kimi-k2.6 |
Lite / Pro / Max / Max10x | $0.95 | $4.00 | $0.16 | - |
kimi-k2.7-code |
Lite / Pro / Max / Max10x | $0.95 | $4.00 | $0.19 | - |
mimo-v2-omni |
Lite / Pro / Max / Max10x | - | - | - | - |
mimo-v2-pro |
Lite / Pro / Max / Max10x | - | - | - | - |
mimo-v2.5 |
Lite / Pro / Max / Max10x | $0.14 | $0.28 | $0.0028 | - |
mimo-v2.5-pro |
Lite / Pro / Max / Max10x | $1.74 | $3.48 | $0.0145 | - |
mimo-v2.5-pro-ultraspeed |
Lite / Pro / Max / Max10x | $52.20 | $104.40 | $0.435 | - |
minimax-m2.5 |
Lite / Pro / Max / Max10x | $0.30 | $1.20 | $0.06 | $0.375 |
minimax-m2.7 |
Lite / Pro / Max / Max10x | $0.30 | $1.20 | $0.06 | $0.375 |
minimax-m3 |
Lite / Pro / Max / Max10x | $0.30 | $1.20 | $0.06 | - |
qwen3.5-plus |
Lite / Pro / Max / Max10x | $0.20 | $1.20 | $0.02 | $0.25 |
qwen3.6-plus |
Lite / Pro / Max / Max10x | ≤256K $0.50>256K $2.00 | ≤256K $3.00>256K $6.00 | ≤256K $0.05>256K $0.20 | ≤256K $0.625>256K $2.50 |
qwen3.7-max |
Lite / Pro / Max / Max10x | $2.50 | $7.50 | $0.50 | $3.125 |
qwen3.7-plus |
Lite / Pro / Max / Max10x | ≤256K $0.40>256K $1.20 | ≤256K $1.60>256K $4.80 | ≤256K $0.04>256K $0.12 | ≤256K $0.50>256K $1.50 |
价格单位为 USD / 1M tokens。模型价格参考 OpenCode Go 与 OpenCode Zen 定价 的公开价格表；mimo-v2.5-pro-ultraspeed 按 mimo-v2.5-pro 的 30x 展示。- 表示该项未单独公开或不适用，实际扣费以控制台账单和服务端定价规则为准。
计费说明
模型调用会按订阅分组的额度和模型价格扣减。大多数模型按上方价格表或控制台配置计费，当前仅高速档模型保留额外倍率说明。
| 模型 ID | 计价规则 | 说明 |
|---|---|---|
| mimo-v2.5-pro-ultraspeed | 30x | 按 mimo-v2.5-pro 基础价格的 30 倍展示，适合需要更快响应的场景。 |
GPT 系列模型当前不再设置 2x 特殊倍率。实际扣费以控制台账单和服务端定价规则为准，切换到高倍率模型前建议先用小请求确认效果和成本。
Chat Completions
这是兼容性最好的文本对话接口。大多数 OpenAI SDK、CLI 工具和代理框架都可以使用这个端点。
{
"model": "deepseek-v4-pro",
"messages": [
{ "role": "system", "content": "You are a concise assistant." },
{ "role": "user", "content": "用三句话介绍 Piaxi CodingPlan。" }
],
"temperature": 0.6,
"stream": false
}Responses API
如果你的客户端使用 OpenAI 新版 Responses API，可以调用 /v1/responses。建议先用小请求确认目标模型是否支持该协议。
curl https://coding.piaxi.fun/v1/responses \
-H "Authorization: Bearer $PIAXI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen3.7-max",
"input": "Reply with exactly: ok",
"stream": false
}'流式输出
将 stream 设置为 true 后，接口会以 Server-Sent Events 返回增量内容。客户端需要按事件流读取响应。
{
"model": "kimi-k2.7-code",
"messages": [
{ "role": "user", "content": "写一个 TypeScript debounce 函数。" }
],
"stream": true
}SDK 与客户端
选择你熟悉的客户端方式，只要它支持自定义 OpenAI Base URL，就可以接入 Piaxi CodingPlan。
from openai import OpenAI
import os
client = OpenAI(
api_key=os.environ["PIAXI_API_KEY"],
base_url="https://coding.piaxi.fun/v1",
)
response = client.chat.completions.create(
model="qwen3.7-max",
messages=[{"role": "user", "content": "Reply with exactly: ok"}],
)
print(response.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.PIAXI_API_KEY,
baseURL: "https://coding.piaxi.fun/v1",
});
const response = await client.chat.completions.create({
model: "deepseek-v4-flash",
messages: [{ role: "user", content: "Reply with exactly: ok" }],
});
console.log(response.choices[0].message.content);OPENAI_API_KEY=sk-your-api-key
OPENAI_BASE_URL=https://coding.piaxi.fun/v1
PIAXI_API_KEY=sk-your-api-key可用性检查
如果请求偶发失败，先确认目标模型是否在模型列表中，再查看控制台里的用量、账号和错误记录。
| 检查项 | 建议 |
|---|---|
| 模型不可用 | 确认模型名称拼写完全一致，并用 GET /v1/models 验证。 |
| 请求失败 | 进入控制台检查账号状态、可用额度、密钥有效性和请求日志。 |
| 账单异常 | 优先检查模型价格表、缓存命中情况和特殊倍率，例如 mimo-v2.5-pro-ultraspeed。 |
错误处理
Piaxi CodingPlan 会尽量保持 OpenAI 兼容错误结构。排查时优先记录 HTTP 状态码、模型名称和返回体里的 message。
| 状态码 | 含义 | 处理方式 |
|---|---|---|
| 401 | API Key 无效或未提供 | 检查 Authorization 请求头，确认密钥未被禁用或复制截断。 |
| 404 | 端点或模型不存在 | 确认使用 /v1 前缀，并检查模型列表。 |
| 429 | 达到速率或额度限制 | 降低并发、切换模型，或等待限制恢复。 |
| 5xx | 服务状态异常 | 稍后重试，并在控制台查看使用记录与错误日志。 |
常见问题
Base URL 应该填哪个？
填 https://coding.piaxi.fun/v1。如果工具把接口路径单独配置为 /chat/completions，不要再重复写 /v1。
为什么同样的 token 数，某些模型扣费更高？
部分高速模型会按倍率计费，例如 mimo-v2.5-pro-ultraspeed 为 30x。GPT 系列模型当前不再设置 2x 特殊倍率。
可以在浏览器前端直接调用吗？
不建议。浏览器前端会暴露 API Key。请让自己的后端服务持有密钥，再由前端调用你的后端。