首次调用 API
获取 API Key,并通过 curl、Python 或 Node.js 完成第一次模型调用。
接口参数
| 参数 | 示例值 | 说明 |
|---|---|---|
base_url | https://api.do.top/v1 | API 服务地址。若兼容 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 编程工具接入指南。