让现有 OpenAI SDK 接入一个生产级网关。

快速答案

应该使用哪个接口？

• 使用 /v1/chat/completions 处理熟悉的 messages 对话格式。
• 应用采用 Responses 风格输入时，使用 /v1/responses，并参考已验证的 Python 与 Agents SDK 指南。
• 已有 Claude Messages 接入时，查看 /v1/messages。
• 需要图像生成时，查看 /v1/images/generations 的参数。

接口参数和可用模型可能变化；请以中文 API 文档和实时 /v1/models 响应为准。生产检查详见模型发现与缓存指南。

使用 cURL 测试

curl https://www.primoraihub.com/v1/models \
  -H "Authorization: Bearer $PRIMORDIAL_API_KEY"

curl https://www.primoraihub.com/v1/chat/completions \
  -H "Authorization: Bearer $PRIMORDIAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "从_v1_models_返回的_MODEL_ID",
    "messages": [{"role": "user", "content": "你好"}]
  }'

使用 OpenAI Python SDK

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["PRIMORDIAL_API_KEY"],
    base_url="https://www.primoraihub.com/v1",
)

configured_id = os.environ["PRIMORDIAL_MODEL_ID"]
models = client.models.list()
available_ids = {model.id for model in models.data}
if configured_id not in available_ids:
    raise RuntimeError(f"配置的模型不可用：{configured_id}")

response = client.chat.completions.create(
    model=configured_id,
    messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)

需要准确区分 Python 的 base_url 与 JavaScript 的 baseURL 构造参数时，请查看自定义 Base URL 迁移指南。

上线前检查

• 获取并缓存当前模型列表，不要硬编码未经验证的模型名称。
• 把 API Key 保存在服务端密钥系统中，不要放入浏览器代码或公开仓库。
• 记录请求 ID、延迟、状态码和 token 用量，但不要记录密钥。
• 发布前在当前文档中确认接口、模型、流式响应和图像参数。

已有账户？请创建或管理 API Key，再按密钥安全与鉴权清单完成测试；Responses 风格应用使用Responses API 自定义 Base URL 指南；配置浏览器聊天客户端时，使用Open WebUI 接入指南；配置服务端管理的自定义端点时，使用LibreChat YAML 指南；配置工作流自动化时，使用n8n HTTP Request 指南；否则继续阅读完整中文 API 文档，或创建账户。

常见问题