OpenAI-compatible API

使用 InfiniteX 当前 Base URL 调用模型列表、Chat Completions 与 Responses

目标

按客户端需要选择 OpenAI-compatible Chat Completions 或 Responses，使用运行时可用模型完成最小请求并核对日志。

前置条件

已创建低额度、短有效期、限制模型的 API 密钥。
已把 Key 存入 INFINITEX_API_KEY，把 /v1/models 返回的模型 ID 存入 INFINITEX_MODEL。
本机已安装 curl。

准确入口

Base URL：https://api.infinitex.pro/v1

操作步骤

先获取当前 Key 可见模型：

curl --fail-with-body --silent --show-error \
  https://api.infinitex.pro/v1/models \
  -H "Authorization: Bearer $INFINITEX_API_KEY"

客户端使用消息数组时调用 Chat Completions：

curl --fail-with-body --silent --show-error \
  https://api.infinitex.pro/v1/chat/completions \
  -H "Authorization: Bearer $INFINITEX_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"model":"'"$INFINITEX_MODEL"'","messages":[{"role":"user","content":"Reply with exactly: InfiniteX OK"}],"max_tokens":16}'

支持 Responses 的客户端使用 /v1/responses：

curl --fail-with-body --silent --show-error \
  https://api.infinitex.pro/v1/responses \
  -H "Authorization: Bearer $INFINITEX_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"model":"'"$INFINITEX_MODEL"'","input":"Reply with exactly: InfiniteX OK"}'

在使用日志按时间核对 endpoint、模型、状态、Token、费用和 request ID。
删除临时 Key并确认不能继续请求。

成功结果

/v1/models 和所选生成 endpoint 返回 HTTP 2xx；使用日志出现匹配记录；撤销 Key 后返回认证失败。

常见错误

状态/现象	可执行检查
`400`	请求 JSON、必填字段和 endpoint 协议是否匹配
`401`	`Bearer` Header、Key 完整性、到期与撤销状态
`403`	IP、模型、分组与账号权限
`404`	API 域名、`/v1` 和 endpoint 路径
`429`	限流、并发、额度与上游状态，按退避策略重试
模型不可用	重新获取 `/v1/models`，核对实时渠道和模型广场

安全与计费影响

每次请求都可能计费。生产中设置超时、重试上限和输出上限；不要在日志、URL、Git 或截图中保存 Key、完整 prompt 与响应。

下一步

阅读模型列表与端点选择，Codex 用户前往Codex 接入。

目录