API 接入指南

models.tips 首页公开展示了 OpenAI 兼容的 Chat Completions 路由。接入前请先从登录后的控制台确认实际基础地址与访问权限。

接入前准备

• API 基础地址：使用控制台显示的地址。
• API 密钥：使用为当前应用创建的访问密钥。
• 模型名称：从模型广场复制准确名称。

curl 请求示例

curl -X POST "<API_BASE_URL>/v1/chat/completions" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<MODEL_NAME>",
    "messages": [
      {"role": "user", "content": "请用一句话介绍你自己。"}
    ],
    "stream": false
  }'

把三个占位符替换为控制台和模型广场中的真实值。不要把密钥发送到公开渠道。

请求字段

• model：目标模型的准确名称。
• messages：对话消息数组。
• role：消息角色，例如 user。
• content：发送给模型的文本内容。
• stream：是否启用流式响应。

读取响应

非流式请求通常从 choices 中读取模型回复，并可能在 usage 中看到 Token 统计。不同协议或模型的实际响应字段可能不同，应以返回结果为准。

流式响应

当 stream 为 true 时，客户端需要逐块处理 SSE 数据并在结束标记后关闭连接。不支持流式处理的客户端应保持为 false。

最小排查清单

• 确认基础地址没有重复拼接 /v1。
• 确认 Authorization 使用 Bearer，密钥前后没有空格。
• 确认模型名称完全一致。
• 确认 JSON 格式正确，账户有可用余额或额度。