开始使用
第一次 API 请求
使用临时低额度密钥发现当前模型、发送最小文本请求并核对使用日志
这一步能完成什么
使用当前推荐 Base URL 获取运行时模型列表,发送一条最小 OpenAI-compatible 请求,并在 InfiniteX 使用日志核对结果和费用。
前置条件
- 已完成登录并创建一个低额度、短有效期、限制模型的 API 密钥。
- 已把完整密钥放入本机环境变量
INFINITEX_API_KEY,不要写进脚本、Shell 历史、截图或 Git。 - 本机已安装
curl;Python 示例需要 Python 3 和当前openai包。
准确入口
- API Base URL:
https://api.infinitex.pro/v1 - API 密钥:https://infinitex.pro/keys
- 使用日志:https://infinitex.pro/usage-logs/common
操作步骤
1. 获取当前可用模型
curl --fail-with-body --silent --show-error \
https://api.infinitex.pro/v1/models \
-H "Authorization: Bearer $INFINITEX_API_KEY"成功响应的 data 数组包含这个 Key 当前能看到的模型。选择一个同时出现在模型广场、可用渠道和该响应中的文本模型,把其 id 放入 INFINITEX_MODEL。不要从旧截图复制模型名。
2. 发送最小 curl 请求
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}"3. 使用 OpenAI Python SDK
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.infinitex.pro/v1",
api_key=os.environ["INFINITEX_API_KEY"],
)
result = client.chat.completions.create(
model=os.environ["INFINITEX_MODEL"],
messages=[
{"role": "user", "content": "Reply with exactly: InfiniteX OK"},
],
max_tokens=16,
)
print(result.choices[0].message.content)4. 核对使用日志并撤销 Key
- 打开 使用日志。
- 按刚才的时间定位记录,核对模型、endpoint、状态、Token 用量、费用和 request ID。
- 回到 API 密钥,删除本次临时 Key。
- 再调用
/v1/models,确认已撤销 Key 返回认证失败;不要把完整错误响应保存到公开材料。
成功结果
/v1/models返回当前 Key 可用的模型集合。/v1/chat/completions返回 HTTP 2xx 和最小文本内容。- 使用日志出现对应记录,费用可核对。
- 删除 Key 后同一 Key 不能再访问 API。
本次运行时验证
运行时验证使用一个 default 分组、1 小时有效、$0.10 有限额度、仅允许一个实时文本模型且 IP 白名单为空的临时 Key:
/v1/models返回 HTTP 200,结果只包含该 Key 允许的一个模型。/v1/chat/completions返回 HTTP 200,最小回复与预期精确一致,响应包含 usage 和 request ID。- 使用日志记录 13 个输入 Token、7 个输出 Token、
$0.000042费用和 3.0 秒用时。 - 临时 Key 永久删除后,列表回到 0;再次访问
/v1/models返回 HTTP 401。
运行时模型名不写入文档,避免把当时可用模型误当长期承诺。完整 Key、prompt、响应和用户信息均未记录。
常见错误
| 现象 | 先检查 |
|---|---|
401 | Key 是否完整、是否已删除或过期,Header 是否为 Bearer |
403 | IP 白名单、模型限制和账号权限 |
| 模型不可用 | 重新请求 /v1/models,核对模型广场、可用渠道和 Key 分组 |
| 额度不足 | Key 有限额度和账号钱包;不要改成无限额度来绕过排查 |
404 | Base URL 是否包含 /v1,endpoint 是否为 /chat/completions |
429 | 当前限流、并发和上游状态;稍后重试并保留 request ID |
安全与计费
两条请求都可能计费。保持 prompt 和输出上限最小,完成后立即核对日志并撤销临时 Key。完整 Key、prompt 和上游响应不得进入截图或反馈材料。
下一步
理解分组、可用渠道与模型广场,再配置长期客户端 Key。
最后更新于