开始之前
在开始之前，请确保你已经：
第一步：获取 API Key
登录账户
使用你的账户登录（与 huajune.duliday.com 使用相同的账户系统）
创建并激活密钥
点击 ”+ 创建” 按钮创建新密钥，确保密钥状态为 “已激活”
复制密钥
点击复制按钮复制完整的 API Key 并妥善保存
安全提示：请勿将 API Key
提交到版本控制系统或公开分享。建议使用环境变量来存储密钥。
第二步：发起第一个请求
选择你熟悉的编程语言，发起第一个 API 请求：
curl -N -X POST https://huajune.duliday.com/api/v1/chat \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "anthropic/claude-3-7-sonnet-20250219",
"messages": [
{
"role": "user",
"content": "你好，请介绍一下你自己"
}
],
"stream": false
}'
记得将 YOUR_API_KEY 替换为你在第一步中获取的实际 API Key。
第三步：理解响应
成功的请求会返回以下格式的 JSON 响应：
{
"success": true,
"data": {
"messages": [
{
"id": "msg_abc123",
"role": "assistant",
"parts": [
{
"type": "text",
"text": "你好！我是花卷智能体..."
}
]
}
],
"usage": {
"inputTokens": 15,
"outputTokens": 45,
"totalTokens": 60
},
"tools": {
"used": [],
"skipped": []
}
}
}
messages: 包含 AI 助手的回复消息 - usage: Token 使用量统计 -
inputTokens: 输入的 token 数量 - outputTokens: 输出的 token 数量 -
totalTokens: 总 token 数量 - tools: 工具使用情况 - used:
本次使用的工具列表 - skipped: 跳过的工具列表
第四步：尝试流式输出
现在让我们尝试更流畅的流式输出，实现类似 ChatGPT 的打字机效果。
流式输出使用 Server-Sent Events (SSE) 协议，可以实时接收 AI 生成的内容，非常适合需要即时反馈的聊天场景。
const response = await fetch("https://huajune.duliday.com/api/v1/chat", {
method: "POST",
headers: {
Authorization: "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "anthropic/claude-3-7-sonnet-20250219",
messages: [
{
role: "user",
content: "作为餐饮招聘助手，介绍一下服务员岗位",
},
],
stream: true, // 启用流式输出
}),
});
// 处理 SSE 流式响应
const reader = response.body.getReader();
const decoder = new TextDecoder();
let accumulatedText = "";
while (true) {
const { done, value } = await reader.read();
if (done) break;
const chunk = decoder.decode(value);
const lines = chunk.split('\n').filter(line => line.trim());
for (const line of lines) {
if (line.startsWith('data: ')) {
const data = line.slice(6); // 去掉 "data: " 前缀
// 检查流结束标记
if (data === '[DONE]') {
console.log('\n流式响应完成');
break;
}
try {
const event = JSON.parse(data);
// 处理文本增量事件
if (event.type === 'text.delta') {
accumulatedText += event.delta;
process.stdout.write(event.delta); // 实时打印
}
// 处理消息完成事件
if (event.type === 'finish') {
console.log('\n消息生成完成');
}
} catch (e) {
// 忽略无法解析的行
}
}
}
}
console.log('\n完整回复:', accumulatedText);
流式响应注意事项：
- 流式响应使用 SSE 格式，每行以
data: 开头
- 流结束时会收到
data: [DONE] 标记（字面量，非 JSON）
- 消息完成时会收到
{"type":"finish"} 事件
- 需要逐行解析 JSON 事件，主要关注
text.delta 类型
- 某些代理服务器可能会缓冲 SSE 响应，建议在生产环境配置
X-Accel-Buffering: no
第五步：查看响应头信息
API 会在响应头中返回一些有用的信息，帮助你监控和优化调用：
const response = await fetch('https://huajune.duliday.com/api/v1/chat', {
// ... 请求配置
});
// 查看响应头
console.log('Correlation ID:', response.headers.get('X-Correlation-Id'));
console.log('消息已剪裁:', response.headers.get('X-Message-Pruned'));
console.log('跳过的工具:', response.headers.get('X-Tools-Skipped'));
const data = await response.json();
请求关联 ID，用于追踪和调试问题，报告 Bug 时请提供此 ID
是否进行了消息剪裁（值为 “true” 或不存在）
被跳过的工具列表（逗号分隔），仅在使用 contextStrategy: "skip" 时出现
常见问题
请检查：
- API Key 是否正确
- Authorization 头格式是否为
Bearer YOUR_API_KEY
- API Key 是否已激活（在 Wolian AI 平台查看状态）
- API Key 是否已过期或被撤销
可能原因：解决方法：使用 GET /api/v1/models 查看可用模型列表curl -X GET https://huajune.duliday.com/api/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"
查看响应中的 tools 字段：{
"success": true,
"data": {
"messages": [...],
"tools": {
"used": ["zhipin_reply_generator"], // 本次使用的工具
"skipped": [] // 跳过的工具（如有）
}
}
}
可以尝试以下优化：
- 使用流式输出 (
stream: true)，让用户立即看到内容开始生成
- 启用消息剪裁 (
prune: true)，减少输入 token 数量
- 选择更快的模型（如
qwen/qwen-plus-latest），牺牲少量质量换取速度
查看 性能优化文档 了解更多技巧 下一步
恭喜！你已经成功完成了第一次 API 调用。接下来你可以：
