水华 Token 工厂
水华 Token 工厂
首次调用 API
AI 编程工具接入指南
OpenCode 自定义模型接入Claude Code 自定义模型接入Hermes 自定义模型接入Cursor 自定义模型接入VS Code GitHub Copilot 自定义模型接入CC-Switch 自定义模型接入Codex App 自定义模型接入CodeBuddy 自定义模型接入Trae 自定义模型接入常见问题与故障排查
联系我们

首次调用 API

获取 API Key,并通过 curl、Python 或 Node.js 完成第一次模型调用。

接口参数

参数示例值说明
base_urlhttps://api.do.top/v1API 服务地址。若兼容 OpenAI SDK,通常以 /v1 结尾。
api_key${API_KEY}平台生成的 API Key,建议通过环境变量读取,不要写死在代码中。
model${your-model-name}要调用的模型名称,例如 deepseek-v4-flash、qwen-plus、glm-5.1。

安全提醒

API Key 相当于账号密码。请通过环境变量或安全存储读取,不要写入公开文档、提交到代码仓库或发送给无关人员。

完整请求地址示例:

https://api.do.top/v1/chat/completions

调用前准备

获取 API Key

在模型平台控制台中创建 API Key。

确认模型名称

调用前请前往本站 模型广场 查看可用模型并复制模型 ID,例如:

deepseek-v4-flash
deepseek-v4-pro
qwen-plus
glm-5.1
kimi-k2.6

如果平台支持模型列表接口,可以先请求:

curl https://api.do.top/v1/models \  -H "Authorization: Bearer ${API_KEY}"

调用对话 API

下面示例均使用 OpenAI-compatible 的 chat/completions 格式。

curl https://api.do.top/v1/chat/completions \  -H "Content-Type: application/json" \  -H "Authorization: Bearer ${API_KEY}" \  -d '{    "model": "${your-model-name}",    "messages": [      {        "role": "system",        "content": "你是一个有帮助的 AI 助手。"      },      {        "role": "user",        "content": "你好,请用一句话介绍一下你自己。"      }    ],    "stream": false  }'

安装 SDK:

pip install openai

调用代码:

import osfrom openai import OpenAIclient = OpenAI(api_key=os.environ.get("API_KEY"),base_url="https://api.do.top/v1",)response = client.chat.completions.create(model="${your-model-name}",messages=[{"role": "system", "content": "你是一个有帮助的 AI 助手。"},{"role": "user", "content": "你好,请用一句话介绍一下你自己。"},],stream=False,)print(response.choices[0].message.content)

安装 SDK:

npm install openai

调用代码:

import OpenAI from "openai"const client = new OpenAI({apiKey: process.env.API_KEY,baseURL: "https://api.do.top/v1",})async function main() {const completion = await client.chat.completions.create({model: "${your-model-name}",messages: [{ role: "system", content: "你是一个有帮助的 AI 助手。" },{ role: "user", content: "你好,请用一句话介绍一下你自己。" },],stream: false,})console.log(completion.choices[0].message.content)}main()

接入 Agent 工具

水华 Token 工厂 API 已接入多种主流 AI Agent 与编程助手工具,具体配置方法请查看 AI 编程工具接入指南。

AI 编程工具接入指南

选择对应的 AI 编程工具,查看自定义模型服务的配置、使用与测试方法。

On this page

接口参数调用前准备获取 API Key确认模型名称调用对话 API接入 Agent 工具