02 / GET CONNECTED

三步，接上你的工作流。

接入地址、Key 与模型清单通过私密邮件交付。
请按专属交付指引配置。

获取你的专属 Key

完成方案确认与付款后，人工交付 Key、额度与可用模型清单。

填写地址与模型

OpenAI 兼容客户端填写下方 Base URL。模型 ID 使用交付清单中的准确值。

小额测试，再开始使用

先发起一次简短请求，再核对余额与用量。续费联系 Run7，由人工处理。

示例从环境变量读取 Key；不要把真实 Key 放入网页源码、截图或公开仓库。

协议选择要点

接入路线	需要确认
Chat Completions	兼容客户端中的基本文本请求
Responses	部分模型工具调用所需协议
Messages	Claude Code 等工具使用的协议
Gemini native	Gemini CLI 所用原生接入路线

协议是否开放取决于模型与 Key 权限。协议转换可能影响工具、推理或多模态参数；请使用私密交付指引指定的地址和路线。

调用失败，先检查哪里？

状态码	建议操作
400	检查 JSON、必填字段与 Content-Type
401	检查 Key 是否正确或已停用
403	检查额度、模型权限与 HTTPS
404	检查路径和是否重复拼接 /v1
413	减小请求内容
429	降低并发，遵循 Retry-After
502 / 503	有限次数退避重试；持续失败联系支持

控制重试次数

429、502、503 可递增等待并设置最大重试次数，遵循 Retry-After。认证与参数问题应先修复。超时不一定代表请求未执行，不要无限重复提交。

提供有效的排错信息

包含时间与时区、工具版本、模型 ID、错误码和请求 ID。移除 Authorization 请求头、完整 Key 和私密提示内容。

API REFERENCE / QUICK REQUEST

构造第一个请求

以下为 macOS / Linux Shell 示例，需安装 Python 3 与 cURL。替换占位符，不要直接使用示例地址。

# macOS / Linux shell. Set these from your private delivery.
export RUN7_BASE_URL="https://YOUR_ENDPOINT/v1"
export RUN7_API_KEY="YOUR_PRIVATE_KEY"
export RUN7_MODEL="YOUR_MODEL_ID"

curl "${RUN7_BASE_URL%/}/chat/completions" \
  -H "Authorization: Bearer $RUN7_API_KEY" \
  -H "Content-Type: application/json" \
  -d "$(python3 -c 'import json,os; print(json.dumps({"model":os.environ["RUN7_MODEL"],"messages":[{"role":"user","content":"Hello"}]}))')"

请求与响应

使用 Bearer 认证与 JSON 请求体。model 是准确模型 ID，messages 包含 role 和 content。普通文本结果位于 choices[0].message.content；响应中的 usage 可用于核对 Token 用量，最终费用查询客户门户。工具调用、流式响应及其他协议需按模型能力单独配置。