文档
进入控制台
文档目录
本页目录

开始使用

快速开始

完成账户准备、创建独立 API Key、选择可用模型，然后用最小请求验证认证、路由和调用记录。

开始前准备

  • 账户有可用余额、订阅额度或其他可消费额度。
  • 知道应用需要 OpenAI Responses、Chat Completions 还是 Anthropic Messages。
  • 能够把密钥保存在环境变量或服务端 Secret 中，而不是网页前端或公开仓库。

创建专用密钥

  1. 进入控制台的 API Key 管理页面，为当前应用单独创建一把 Key。
  2. 选择符合用途的分组，并核对有效期、总额度、IP 规则和可用限额。
  3. 只在创建时安全保存完整密钥；生产、测试和本地环境不要共用同一把 Key。

完整权限与轮换规则见API Key 与权限。

选择模型与分组

在模型广场确认模型 ID、可用分组、价格和当前状态。可见模型不一定能由当前 Key 调用，最终权限由 Key 所属分组和账户状态共同决定。

cURL · 查询当前 Key 可见模型
curl https://api.khaix.net/v1/models \
  -H "Authorization: Bearer $KHAIX_API_KEY"

发送第一条请求

先发送不含工具、结构化输出、附件和特殊推理参数的非流式请求，排除高级能力带来的变量。

cURL · Responses
curl https://api.khaix.net/v1/responses \
  -H "Authorization: Bearer $KHAIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "请只回复：连接成功"
  }'

示例模型仅用于展示格式；如果当前 Key 不可见，请替换为模型广场或 /v1/models 返回的模型 ID。

核对调用结果

  • 响应：HTTP 状态为 2xx，响应中包含模型输出。
  • 记录：控制台出现对应时间、Key、模型、分组、状态和用量。
  • 追踪：保留响应头中的 X-Request-Id；不要在工单中提供完整 Key 或敏感 Prompt。
  • 下一步：分别增加流式、工具、结构化输出或图片输入，不要一次打开所有高级能力。

失败时先查看错误与重试，再使用排错与安全中的最小诊断流程。