LaoZhang API

概述

LaoZhang API 是一个统一的多模型 API 网关，旨在解决开发者同时对接多个 AI 模型（如文本、推理、图像、视频、视觉和音频）时面临的接口碎片化、认证分散和成本管理复杂的问题。通过本教程，你将学会如何快速集成该网关，实现单一密钥调用多种模型，并统一管理请求日志与配额。

前置条件

• 一个有效的 LaoZhang API 账号（注册地址：https://www.laozhang.ai/）
• 至少一个 API 密钥（创建路径：控制台 → API Keys → 创建新密钥）
• 目标模型 ID 列表（如 gpt-4o、claude-3-opus、dall-e-3 等，可在模型目录页面查询）

分步操作

1. 获取并配置 API 密钥

1. 登录 LaoZhang 控制台，进入 API Keys 页面。
2. 点击 创建新密钥，输入密钥名称（如“生产环境密钥”），选择权限范围（建议先选“只读”用于测试）。
3. 复制生成的密钥字符串（格式如 sk-xxxxxxxxxxxxxxxx），立即保存到安全位置（如密码管理器或环境变量文件），页面关闭后无法再次查看完整密钥。

2. 选择目标模型并确认端点

1. 在控制台 模型目录 中，找到你需要的模型。
2. 记录该模型的 ID（例如 text-davinci-003 或 gpt-4-vision-preview）以及对应的 端点路径（通常为 https://api.laozhang.ai/v1/chat/completions 或 https://api.laozhang.ai/v1/images/generations）。
3. 注意：不同模型可能使用不同的端点，但认证方式（API Key）和基础 URL 保持一致。

3. 发送第一个请求（以文本生成为例）

1. 使用 curl 或你熟悉的 HTTP 客户端（如 Postman、Python requests）发送 POST 请求。
2. 请求头必须包含：

• Authorization: Bearer <你的API密钥>
• Content-Type: application/json

3. 请求体示例（文本生成）：

   {
     "model": "gpt-4o",
     "messages": [
       {"role": "user", "content": "Hello, what is the capital of France?"}
     ],
     "max_tokens": 100
   }

4. 执行请求，预期返回包含 choices[0].message.content 字段的 JSON 响应，内容应为“Paris”。

4. 验证多模型调用（图像生成示例）

1. 保持相同的 API 密钥和基础 URL，但将端点改为 /v1/images/generations。
2. 请求体示例：

   {
     "model": "dall-e-3",
     "prompt": "A cute cat sitting on a mat",
     "n": 1,
     "size": "1024x1024"
   }

3. 预期返回包含 data[0].url 字段，指向生成的图片。

5. 查看调用日志与配额

1. 进入控制台 日志 页面，可查看每次请求的耗时、模型、token 消耗和状态码。
2. 在 配额 页面，可查看当前套餐的剩余调用次数、token 上限和过期时间。
3. 若发现请求失败，优先检查日志中的 error 字段，常见原因包括：密钥过期、模型 ID 拼写错误、超出配额。

常见问题与排查

预期结果

完成上述步骤后，你将能够：

• 使用单一 API 密钥调用文本、图像、视频、音频等多种模型。
• 在控制台统一查看所有模型的调用记录和费用。
• 快速切换不同模型进行对比测试，无需修改认证逻辑。
• 根据日志和配额数据，合理规划资源使用。