OpenAI 兼容接口接入指南：从密钥到第一次调用

本文以天智鲲鹏 AI 能力平台为例，说明如何完成第一次模型调用。示例使用 OpenAI 兼容协议，更换 base_url 即可复用现有代码。

一、准备工作

1. 注册账号并完成手机号验证；
2. 在“AI 套餐”页面购买套餐，额度即时到账；
3. 进入“AI 控制台”，创建一个 API Key；
4. 完整 Key 只显示一次，请立即保存到密码管理器或环境变量。

不要把 Key 写入前端代码、Git 仓库或聊天记录。建议按环境创建不同 Key，便于吊销和排查。

二、接口信息

• 地址：https://www.5ifbi.com/api/v1/chat/completions
• 方法：POST
• 请求头：Authorization: Bearer sk-tzkp-...、Content-Type: application/json
• 模型：使用平台公布的别名，例如 tzkp-fast

三、用 cURL 调用

export TZKP_API_KEY="sk-tzkp-你的密钥"

curl https://www.5ifbi.com/api/v1/chat/completions   -H "Authorization: Bearer $TZKP_API_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "tzkp-fast",
    "messages": [
      {"role": "user", "content": "用三点说明什么是 token 计量"}
    ],
    "temperature": 0.7
  }'

四、用 Python 调用

安装 OpenAI SDK：

pip install openai

调用代码：

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://www.5ifbi.com/api/v1",
    api_key=os.environ["TZKP_API_KEY"],
)

resp = client.chat.completions.create(
    model="tzkp-fast",
    messages=[
        {"role": "system", "content": "你是企业数字化顾问，回答简洁。"},
        {"role": "user", "content": "用三点说明什么是 token 计量"},
    ],
)

print(resp.choices[0].message.content)
print(resp.usage.total_tokens)

五、理解返回

返回结构与 OpenAI Chat Completions 基本一致：

• choices[0].message.content：生成内容；
• usage.prompt_tokens：输入 token；
• usage.completion_tokens：输出 token；
• usage.total_tokens：合计，用于额度扣减；
• _gateway：平台附加的请求 ID、模式和模型别名。

响应头中的 X-Request-Id 可用于排查问题，X-TZKP-Quota-Remaining 显示本次调用后的剩余额度。

六、常见错误

七、接入建议

1. 把 Key 放在服务端环境变量中，不暴露给浏览器；
2. 设置超时和重试，但不要无限重试；
3. 记录请求 ID、token 和耗时，便于对账；
4. 对输出做必要审核后再展示给最终用户；
5. 不要提交未脱敏的个人信息或商业秘密。

结语

第一次调用只需要一个 Key 和一段 JSON。真正的工作在于错误处理、成本控制和内容安全，这些将在后续文章中展开。