Weelinking

学完能做什么 / 解决什么问题

通过本教程，你将学会使用 Weelinking 提供的 AI API 服务，完成以下任务：

• 调用 GPT、Claude、DeepSeek 等主流模型，为你的应用或网站添加 AI 对话、文本生成能力。
• 获取稳定、低延迟的 API 接口，避免因第三方服务不稳定导致的业务中断。
• 在 10 分钟内完成从注册到首次 API 调用的全流程，无需自行部署模型或管理服务器。

前置条件

开始操作前，请确保你具备以下条件：

• 一个可用的邮箱地址（用于注册 Weelinking 账号）。
• 一个支持 HTTP 请求的开发环境（如 Python、Node.js、curl 等）。
• 基本的 API 调用知识（如 HTTP 方法、请求头、JSON 格式）。

分步操作

1. 注册并登录 Weelinking 账号

• 访问 Weelinking 官网。
• 点击页面右上角的“注册”按钮。
• 输入邮箱地址，设置密码，完成邮箱验证。
• 登录后，进入控制台主页。

2. 创建 API Key

• 在控制台左侧导航栏，点击“API 密钥”或“API Keys”。
• 点击“创建新密钥”按钮。
• 输入密钥名称（如“生产环境”或“测试”），点击“确认”。
• 复制生成的 API Key 并保存到安全位置。注意：关闭页面后无法再次查看完整密钥，需重新生成。

3. 选择模型并获取接口地址

• 在控制台导航栏，点击“模型列表”或“Models”。
• 查看支持的模型列表，包括 GPT-4、GPT-3.5、Claude-3、DeepSeek-V2 等。
• 选择你需要的模型，记录其对应的接口路径（例如 /v1/chat/completions）。
• 默认 API 基础地址为 https://api.weelinking.com。

4. 发起首次 API 调用

以下示例使用 curl 调用 GPT-3.5 模型：

curl https://api.weelinking.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-3.5-turbo",
    "messages": [{"role": "user", "content": "Hello, world!"}]
  }'

• 将 YOUR_API_KEY 替换为你在步骤 2 中生成的密钥。
• 如果调用成功，你将收到类似以下 JSON 响应：

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help you today?"
      }
    }
  ]
}

5. 集成到你的应用

• 将 API 基础地址、密钥和模型参数配置到你的代码中。
• 示例：Python 使用 requests 库

import requests

url = "https://api.weelinking.com/v1/chat/completions"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "model": "gpt-3.5-turbo",
    "messages": [{"role": "user", "content": "Hello"}]
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

预期结果

• 完成上述步骤后，你的应用应能通过 Weelinking API 正常调用 AI 模型，并返回响应。
• API 响应时间通常在 1-5 秒内（取决于模型和请求复杂度）。
• 控制台仪表盘会显示调用次数、延迟和错误率等指标。

常见问题与排查

注意事项

• 密钥安全：不要将 API Key 硬编码在公开代码仓库中，建议使用环境变量或密钥管理服务。
• 模型选择：不同模型定价不同，建议在控制台查看价格表后选择适合业务场景的模型。
• 错误处理：在代码中实现重试逻辑（如指数退避），以应对临时性网络或服务故障。
• 合规使用：遵守 Weelinking 服务条款，不得用于违法或滥用场景。