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

快速答案

应该使用哪个接口？

• 使用 /v1/chat/completions 处理熟悉的 messages 对话格式。
• 应用采用 Responses 风格输入时，查看 /v1/responses 的当前文档。
• 已有 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

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_PRIMORDIAL_API_KEY",
    base_url="https://www.primoraihub.com/v1",
)

models = client.models.list()
model_id = models.data[0].id

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

上线前检查

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

继续阅读完整中文 API 文档，或创建账户。

常见问题