器灵科技 API 官方文档

1.1 平台简介

器灵科技聚合千问、DeepSeek、Kimi、GLM、MiniMax、HappyHorse、万相等全系列大模型，完全兼容 OpenAI / DeepSeek 标准接口格式，统一地址、统一鉴权、统一计费，一次对接全模型可用。

1.2 使用流程总览

注册账号 → 完成个人实名认证 → 账户充值 → 创建 API 秘钥 → 对接接口调用模型

充100元送5元，活动截止时间：2026年06月30日。

2.1 账号注册

仅支持手机号 + 短信验证码注册，不支持邮箱、第三方快捷登录。

采用账号密码登录方式，无其他登录入口。

3. 实名认证

目前仅开放个人实名认证，企业认证将在后续版本上线。

认证资料：身份证信息 + 人脸核验
审核时效：提交后即时审核通过
未完成实名无法调用模型接口、无法使用服务。

4. 账户充值说明

4.1 支持支付方式

微信支付、支付宝、对公汇款三种方式全覆盖。

4.2 充值规则

最低起充金额：10 元
私人微信/支付宝充值：付款后实时到账
对公汇款：转账完成后，请点击【联系我们】，通过企业微信联系售后人工核对入账。

4.3 余额规则

余额展示格式：¥81.80 CNY，金额固定保留两位小数
余额低于 5 元时，系统自动发送短信余额预警通知。

5. API 秘钥管理

秘钥入口：登录后台 → 用户中心 → API 秘钥
秘钥格式：统一以 sk-xxxxxx 开头
支持创建多个秘钥，仅可删除、无禁用功能
平台默认提供全局可用秘钥，用户也可自主新建管理
安全建议：切勿公开泄露 API 秘钥，禁止将其硬编码至公开代码，建议定期轮换秘钥。

6. 接口基础配置

6.1 统一请求地址（Base URL）

http://localhost:38419/api/v1/chat/completions

6.2 兼容规范

完全兼容 OpenAI / DeepSeek 请求与响应格式，所有模型共用同一个接口地址，无需修改域名，仅切换 model 参数即可。

6.3 公共请求头

Authorization: Bearer 你的sk开头API秘钥
Content-Type: application/json

6.4 通用请求参数说明

参数	说明	是否必填
model	模型调用标识	是
messages	对话上下文数组	是
temperature	随机性 0~1	否
max_tokens	最大生成长度	否

7.1 千问系列 Qwen

模型介绍

阿里百炼旗舰大模型，分为 Max/Plus/Flash 三个档位：

Max：旗舰高阶版，复杂推理、创作、逻辑分析能力极强，适合专业办公、论文撰写、深度思考；
Plus：均衡商用版，性价比高，日常对话、文案创作、业务场景全覆盖；
Flash：极速轻量版，响应快、低延迟，适合高频问答、接口批量调用。

调用标识列表

qwen3.6-max-preview
qwen3-max
qwen3-max-2026-01-23
qwen3-max-2025-09-23
qwen3-max-preview
qwen-max
qwen-max-latestBatch
qwen-max-2025-01-25
qwen-max-2024-09-19
qwen-max-2024-04-28
qwen3.6-plus
qwen3.6-plus-2026-04-02
qwen3.5-plus
qwen3.5-plus-2026-04-20
qwen3.5-plus-2026-02-15
qwen-plus
qwen-plus-latestBatch
qwen-plus-2025-12-01
qwen-plus-2025-09-11
qwen-plus-2025-07-28
qwen-plus-2025-07-14
qwen-plus-2025-04-28
qwen-plus-2025-01-25
qwen-plus-2025-01-12
qwen-plus-2024-12-20
qwen3.6-flash
qwen3.6-flash-2026-04-16
qwen3.5-flash
qwen3.5-flash-2026-02-23
qwen-flash

7.2 DeepSeek 系列

模型介绍

DeepSeek 深度求索系列模型，含通用对话、推理模型、蒸馏小模型；同时接入硅基流动、万擎三方渠道版本，可满足高并发、低门槛、强推理等多场景需求。

调用标识列表

deepseek-v4-pro
deepseek-v4-flash
deepseek-v3.2
deepseek-v3.2-exp
deepseek-v3.1
deepseek-r1
deepseek-r1-0528
deepseek-v3
deepseek-r1-distill-qwen-1.5b
deepseek-r1-distill-qwen-7b
deepseek-r1-distill-qwen-14b
deepseek-r1-distill-qwen-32b
deepseek-r1-distill-llama-8b
deepseek-r1-distill-llama-70b
siliconflow/deepseek-v3.2
siliconflow/deepseek-v3.1
terminus
siliconflow/deepseek-r1-0528
siliconflow/deepseek-v3-0324
vanchin/deepseek-v3.2-think
vanchin/deepseek-v3.1-terminus
vanchin/deepseek-r1
vanchin/deepseek-v3
vanchin/deepseek-ocr

7.3 Kimi 系列

模型介绍

Kimi 长文本强项模型，支持超长上下文、文档解析、知识总结、精细创作，适合阅读论文、解析合同、长内容问答等场景。

调用标识列表

kimi-k2.6
kimi-k2.5
kimi-k2-thinking
Moonshot-Kimi-K2-Instruct
kimi/kimi-k2.5
kimi/kimi-k2.6

7.4 GLM 智谱系列

模型介绍

智谱 GLM 全能力大模型，通用对话、代码生成、逻辑推理、多任务处理能力均衡，适合开发接入、企业业务系统集成。

调用标识列表

glm-5.1
glm-5
glm-4.7
glm-4.6
glm-4.5
glm-4.5-air

7.5 MiniMax 系列

模型介绍

MiniMax 商用级大模型，对话流畅、人设稳定、多轮记忆能力强，适合智能客服、虚拟人设、交互式对话等场景。

调用标识列表

MiniMax-M2.5
MiniMax-M2.1
MiniMax/MiniMax-M2.7
MiniMax/MiniMax-M2.5
MiniMax/MiniMax-M2.1

7.6 图像 / 视频生成系列

模型介绍

包含 Z 图像、HappyHorse、万相系列，支持文生视频、图生视频、首帧/首尾帧续画、视频编辑等能力，可实现一站式图文视频生成。

调用标识列表

z-image-turbo
happyhorse-1.0-t2v
happyhorse-1.0-i2v
happyhorse-1.0-r2v
happyhorse-1.0-video-edit
wan2.7-t2v-2026-04-25
wan2.7-t2v
wan2.6-t2v
wan2.5-t2v-preview
wan2.2-t2v-plus
wanx2.1-t2v-turbo
wanx2.1-t2v-plus
wan2.7-i2v-2026-04-25
wan2.7-i2v
wan2.6-i2v-flash
wan2.6-i2v
wan2.5-i2v-preview
wan2.2-i2v-flash
wan2.2-i2v-plus
wanx2.1-i2v-turbo
wanx2.1-i2v-plus
wan2.2-kf2v-flash
wanx2.1-kf2v-plus

8. 完整接口调用示例

8.1 Curl 通用调用

curl http://localhost:38419/api/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-你的API秘钥" \
-d '{
  "model": "qwen3-max",
  "messages": [
    {"role":"user","content":"你好，请做自我介绍"}
  ],
  "temperature": 0.7,
  "max_tokens": 2048
}'

8.2 Python 调用（OpenAI 兼容包）

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的API秘钥",
    base_url="http://localhost:38419/api/v1/chat/completions"
)

response = client.chat.completions.create(
    model="qwen3-max",
    messages=[
        {"role": "user", "content": "你好，请做自我介绍"}
    ],
    temperature=0.7
)

print(response.choices[0].message.content)

8.3 JavaScript Node.js 调用

const fetch = require('node-fetch');

async function chat() {
  const res = await fetch("http://localhost:38419/api/v1/chat/completions", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Bearer sk-你的API秘钥"
    },
    body: JSON.stringify({
      model: "qwen3-max",
      messages: [{role:"user", content:"你好，请做自我介绍"}],
      temperature: 0.7
    })
  });
  const data = await res.json();
  console.log(data.choices[0].message.content);
}
chat();

8.4 调用切换说明

只需替换 model 字段为上方任意模型标识，接口地址、请求头、代码逻辑无需修改，全模型通用。

9. Agent 工具接入指南（全平台通用·极简四步配置）

所有工具统一适配 OpenAI 兼容协议，共用同一接口地址、同一 API Key，仅需简单配置即可一键接入平台全部大模型。

统一固定配置信息：

Base URL：http://localhost:38419/api/v1/chat/completions
密钥格式：sk-xxxx 开头
支持模型：千问 / DeepSeek / Kimi / GLM / MiniMax / 图文视频全系列

9.1 接入 Claude Code

专业 AI 编程 Agent，支持代码生成、工程重构、终端操作与函数工具调用，可无缝使用平台全部大模型。

安装最新版 Claude Code，确保其支持自定义 OpenAI 兼容接口；
登录器灵科技，进入用户中心-API 秘钥，创建并复制 sk 开头密钥；
配置时选择 OpenAI Compatible，填入上方固定 Base URL 与你的 API 秘钥；
在模型列表中任选平台模型，即可开启 Agent 对话、代码开发与工具调用。

9.2 接入 GitHub Copilot

VS Code 官方智能编程助手，接入后可将平台模型替换原生模型，保留全部 Agent 模式、工具调用能力。

安装 VS Code 及 GitHub Copilot 插件，并保持正常订阅可用状态；
登录器灵科技，创建并复制 sk 开头 API 秘钥；
在插件内自定义服务商，填入固定 Base URL 和 API 秘钥；
在模型选择器中选中平台任意模型，即可直接使用 Copilot 全部功能。

9.3 接入 GitHub Copilot CLI

命令行版本 Copilot，可在终端内实现智能问答、代码解释、命令生成，兼容自定义大模型接入。

安装并配置好 GitHub Copilot CLI 环境；
获取器灵科技 sk 开头 API 秘钥；
配置自定义 OpenAI 接口地址与密钥；
指定平台模型，即可在终端直接对话使用。

9.4 接入 Kilo Code

开源 VS Code AI 编程插件，轻量化、高自定义，完全兼容第三方 OpenAI 模型接入。

在插件市场安装 Kilo Code；
复制平台 sk 开头 API 秘钥；
添加自定义服务商，填入固定 Base URL 和密钥；
选择平台任意模型，即可实现代码补全、问答、工程分析。

9.5 接入 WorkBuddy/CodeBuddy

全能开发助手，支持代码编写、BUG 排查、项目解读，适配标准 OpenAI 接入方式。

安装并打开 WorkBuddy/CodeBuddy 客户端；
前往平台获取 API 秘钥；
自定义接口配置，填写统一地址与密钥；
切换模型为平台任意版本，即可即刻正常使用全部功能。

9.6 接入 OpenCode

开源免费 AI 代码助手，轻量化部署、支持多模型切换，适配兼容接口一键接入。

部署或安装 OpenCode 客户端；
创建并复制器灵科技 API 秘钥；
在服务商设置中选择 OpenAI 兼容，填入接口地址与密钥；
选定模型后，即可用于代码创作与问题咨询。

9.7 接入 Oh My Pi

智能对话与生活助手类 Agent，支持多轮上下文、人设对话，兼容标准大模型接口。

安装 Oh My Pi 客户端/插件；
复制平台 sk 密钥；
新增自定义模型源，填入固定 Base URL 和密钥；
选择平台模型，即可直接开启多轮智能对话。

9.8 接入 OpenClaw

全能自主任务 Agent，可自动执行复杂任务、联网检索、工具调用，支持通过兼容接口替换模型。

安装最新版 OpenClaw；
登录平台获取 API 秘钥；
在模型配置中添加 OpenAI 兼容源，填写接口地址与密钥；
选用平台任意大模型，即可驱动自主任务与工具能力。

9.9 接入 AstrBot

多功能机器人框架，支持私聊、群聊、插件扩展，可接入第三方兼容大模型作为底层推理引擎。

部署完成 AstrBot 框架；
准备器灵科技 sk 开头 API 秘钥；
配置 OpenAI 兼容通道，填入统一接口地址与密钥；
指定平台模型作为默认推理模型，即可正常运营使用。

9.10 接入 Deep Code

专注于代码深度分析、重构、优化的 AI 编程工具，支持自定义模型源接入。

安装 Deep Code 工具；
复制平台 API 秘钥；
配置自定义 OpenAI 接口信息；
切换至平台模型，用于代码解读、优化与改写。

9.11 接入 Hermes

通用智能 Agent 框架，支持工具调用、知识库问答，兼容标准大模型接入协议。

部署 Hermes 框架环境；
获取平台有效 API 秘钥；
填入固定 Base URL 与密钥配置模型源；
选择对应模型，即可启用知识库与工具调用能力。

9.12 接入 nanobot

轻量化智能聊天机器人，部署简单、适配多场景，支持第三方兼容模型接入。

安装并部署 nanobot；
复制器灵科技 sk 密钥；
配置 OpenAI 兼容接口参数；
绑定平台模型，即可实现日常对话与问答服务。

9.13 接入 Crush

智能对话与个性化人设 Agent，长上下文多轮对话稳定，支持自定义模型替换。

打开 Crush 客户端；
获取平台 API 秘钥；
新增兼容模型通道，填写接口地址与密钥；
选用平台模型，即可使用个性化对话能力。

9.14 接入 Pi

知名智能生活助手，支持情感对话、日常咨询，可通过兼容接口替换底层模型。

安装 Pi 客户端；
准备平台 sk 开头密钥；
自定义接口配置，填入统一 Base URL 和密钥；
切换模型后，即可正常进行多轮对话。

9.15 接入 Reasonix

强逻辑推理型 Agent，擅长复杂思考、数理推理、逻辑分析，适配标准接入方式。

部署 Reasonix 运行环境；
复制平台 API 秘钥；
配置 OpenAI 兼容接口；
选择平台推理类模型，即可开启深度逻辑推理能力。

9.16 接入 Langcli

命令行智能交互工具，可在终端内实现问答、翻译、代码生成，支持自定义大模型。

安装 Langcli 工具；
获取器灵科技 API 秘钥；
配置接口地址与鉴权密钥；
指定平台模型，即可在终端一键调用。

9.17 统一通用说明

以上所有 Agent 工具配置逻辑完全一致，仅客户端操作界面略有区别；
全程只需记住固定 Base URL + 自己的 sk 密钥，无需额外修改其他参数；
切换模型仅需修改调用 model 字段，接口地址、请求头无需变动；
若出现 401/403/429 报错，参照文档 FAQ 对应方案排查即可。

10. 计费规则 & 账单用量说明

10.1 计费规则

全部模型按 Token 计费，输入 Token、输出 Token 分开计价；
每个模型、每个版本独立定价，价格以平台模型定价页为准；
无缓存 Token 统计项。

10.2 账单明细字段

订单编号、调用时间、模型名称、输入Token、输出Token、单价、扣费金额

10.3 账单导出

支持按月维度 Excel 导出，导出字段与账单明细完全一致。

10.4 个人中心用量展示

剩余金额、已使用金额、累计消费金额（统一格式：¥0.00 CNY）

11. 常见问题 FAQ

11.1 401 错误

API Key 错误、秘钥过期或鉴权失败；处理方式：重新复制秘钥、删除旧秘钥并新建替换、检查请求头格式无多余空格。

11.2 403 错误

未完成个人实名认证或账户余额不足；处理方式：完成人脸实名、及时充值保证余额充足。

11.3 429 错误

请求频次超限、并发过高；处理方式：降低请求并发量、增加请求间隔、添加重试机制。

11.4 500 错误

平台内部服务异常；处理方式：稍后重试，若仍异常可联系售后客服。

11.5 API 秘钥泄露怎么办

立即在用户中心删除已泄露秘钥；
重新创建新秘钥并更新所有业务配置；
查看账单调用日志，核对是否存在异常扣费；
建议定期轮换秘钥，禁止在公网明文泄露。

11.6 如何切换不同模型

无需修改接口地址与请求头，仅需修改请求体中 model 参数为对应模型版本号即可，全模型共用同一接口。

12. 联系我们

对公转账、接口对接异常、额度问题、秘钥问题，均可通过官网【联系我们】入口，添加企业微信售后，快速处理入账与技术问题。

器灵科技 API 官方文档

1.1 平台简介

1.2 使用流程总览

1.3 新用户活动

2.1 账号注册

2.2 账号登录

3. 实名认证

4. 账户充值说明

4.1 支持支付方式

4.2 充值规则

4.3 余额规则

5. API 秘钥管理

6. 接口基础配置

6.1 统一请求地址（Base URL）

6.2 兼容规范

6.3 公共请求头

6.4 通用请求参数说明

7.1 千问系列 Qwen

7.2 DeepSeek 系列

7.3 Kimi 系列

7.4 GLM 智谱系列

7.5 MiniMax 系列

7.6 图像 / 视频生成系列

8. 完整接口调用示例

8.1 Curl 通用调用

8.2 Python 调用（OpenAI 兼容包）

8.3 JavaScript Node.js 调用

8.4 调用切换说明

9. Agent 工具接入指南（全平台通用·极简四步配置）

9.1 接入 Claude Code

9.2 接入 GitHub Copilot

9.3 接入 GitHub Copilot CLI

9.4 接入 Kilo Code

9.5 接入 WorkBuddy/CodeBuddy

9.6 接入 OpenCode

9.7 接入 Oh My Pi

9.8 接入 OpenClaw

9.9 接入 AstrBot

9.10 接入 Deep Code

9.11 接入 Hermes

9.12 接入 nanobot

9.13 接入 Crush

9.14 接入 Pi

9.15 接入 Reasonix

9.16 接入 Langcli

9.17 统一通用说明

10. 计费规则 & 账单用量说明

10.1 计费规则

10.2 账单明细字段

10.3 账单导出

10.4 个人中心用量展示

11. 常见问题 FAQ

11.1 401 错误

11.2 403 错误

11.3 429 错误

11.4 500 错误

11.5 API 秘钥泄露怎么办

11.6 如何切换不同模型

12. 联系我们