接入文档 — InchLab API

快速开始

我们的接口与 OpenAI 官方接口完全兼容。你只需要两步：

获取 API Key：注册并登录控制台，在「API Keys」页面点击创建，复制以 sk- 开头的密钥。
替换 Base URL：把代码里的接口地址改成我们的地址，即可用同一个 Key 调用全部模型。

💡 注册即送体验额度，无需绑定支付方式即可开始测试。

Base URL

所有接口地址统一为：

https://ininchlab.xyz/v1

兼容的接口路径包括：

/v1/chat/completions — 对话补全（最常用）
/v1/completions — 文本补全
/v1/embeddings — 向量嵌入
/v1/models — 查询可用模型列表

💡 这就是你需要记住的唯一地址，把官方 SDK 里的 base_url 换成它即可。

curl 调用示例

基础对话

curl https://ininchlab.xyz/v1/chat/completions \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "system", "content": "你是一个乐于助人的助手。"},
      {"role": "user", "content": "你好，介绍一下你自己"}
    ]
  }'

模型切换

想换模型？只需要修改 model 字段，例如：

"model": "deepseek-chat"     # DeepSeek V3 对话
"model": "deepseek-reasoner" # DeepSeek R1 推理
"model": "glm-4-plus"       # 智谱 GLM-4-Plus
"model": "glm-4-flash"      # 智谱 GLM-4-Flash（限时免费）
"model": "glm-5.3-flash"    # 智谱最新 · 原生多模态 · 1M 上下文
"model": "qwen-max"         # 通义千问旗舰
"model": "qwen-turbo"       # 通义千问 Turbo

OpenAI SDK

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的APIKey",
    base_url="https://ininchlab.xyz/v1",   # 只需改这一行
)

resp = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的APIKey",
  baseURL: "https://ininchlab.xyz/v1",   // 只需改这一行
});

const resp = await client.chat.completions.create({
  model: "deepseek-chat",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

流式输出（SSE）

与官方一致，设置 "stream": true 即可获得流式响应，适合接入聊天前端：

curl https://ininchlab.xyz/v1/chat/completions \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "stream": true,
    "messages": [{"role": "user", "content": "讲个笑话"}]
  }'

流式请求的计费与普通请求一致，按实际生成的 token 数计算，不会有额外费用。

接入自建本地模型

如果你（或你的朋友）部署了本地模型服务，只要它提供 OpenAI 兼容接口，即可接入本平台统一对外提供：

vLLM 部署的服务：原生兼容 OpenAI 接口，提供 Base URL 与 Key 即可。
Ollama：地址形如 http://192.168.x.x:11434/v1，兼容 OpenAI 格式。
LM Studio / llama.cpp server：同样提供 OpenAI 兼容端点。
其他中转站渠道：直接添加为上游渠道，自动纳入路由池。

👉 站长可在管理后台「渠道」中填写对方提供的 Base URL 与 Key，并给模型命名（如 local-llama3），用户即可直接调用。

客户端接入教程

我们的接口与 OpenAI 官方完全兼容，几乎所有 AI 工具都支持"自定义 OpenAI 兼容接口地址"。接入方法就一句话：把工具的接口地址换成 https://ininchlab.xyz/v1，把 Key 换成你在本站创建的 API Key，其他什么都不用动。

聊天客户端（Cherry Studio / NextChat / LobeChat）

打开软件设置 → 找到「模型服务商 / 模型供应商」
选择（或添加）OpenAI 类型，或选择「自定义接口」
接口地址（Base URL）填：https://ininchlab.xyz/v1
API Key 填：你在控制台创建的 sk-xxx
模型名填：控制台展示的模型名（如 deepseek-chat、glm-4-plus）

Dify / FastGPT / n8n 等平台

添加模型供应商时选择 OpenAI-API-Compatible（或 OpenAI 类型）
API Base URL 填：https://ininchlab.xyz/v1
API Key 填：sk-xxx，选择模型后即可使用

自己写代码（任意语言）

只需把 SDK 的 base_url 指向我们：

from openai import OpenAI
client = OpenAI(
    api_key="sk-你的APIKey",
    base_url="https://ininchlab.xyz/v1",   # 唯一需要改的地方
)
resp = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

模型列表

查询当前可用模型：

curl https://ininchlab.xyz/v1/models \
  -H "Authorization: Bearer sk-你的APIKey"

当前接入的模型速查：

模型名（model 字段）	说明
`deepseek-chat`	DeepSeek V3，性价比极高的对话模型
`deepseek-reasoner`	DeepSeek R1 推理模型，擅长复杂推理
`glm-4-plus`	智谱 GLM-4-Plus，中文能力强
`glm-4-flash`	智谱 GLM-4-Flash，限时免费
`glm-5.3-flash`	智谱最新原生多模态模型，1M 上下文，支持图片输入
`qwen-max`	通义千问旗舰模型
`qwen-turbo`	通义千问 Turbo，高性价比
`local-*`	自建/朋友部署的本地模型（按渠道命名）

我们专注接入国产优质大模型，不接入 OpenAI/Claude/Gemini 等海外模型。

错误码说明

HTTP 状态码	说明	处理建议
`401`	API Key 无效或未提供	检查请求头 Authorization 是否正确
`402`	余额不足	前往控制台充值
`404`	模型不存在	确认模型名拼写，或查看模型列表
`429`	请求过于频繁，触发限流	降低并发，稍后重试
`500`	上游服务异常	稍后重试；系统会自动切换备用渠道
`503`	服务维护中	关注状态页公告

速率限制

为防止滥用，默认速率限制如下（可在控制台按 Key 单独配置）：

项目	默认限制
请求频率	60 次 / 分钟 / Key
并发上限	10 个 / Key

返回 429 时，响应头中的 Retry-After 会告知需要等待的秒数。如需更高限额，请联系站长调整。

计费说明

每次调用按「输入 tokens × 输入单价 + 输出 tokens × 输出单价」实时结算。
请求以 stream 方式输出时，按实际生成的 tokens 计费。
余额为 0 或不足时，请求将返回 402，不会产生欠费。
充值后余额永久有效，不过期、不绑定套餐周期。
可在控制台查看每笔调用的明细费用与用量统计。

如需更详细的 API 说明或有其他问题，请通过控制台联系我们，24 小时在线。