INTEGRATION GUIDE

AI API 接入指南:Base URL、Key 与三种请求格式

从账户入口创建或获取 API Key,再通过 OpenAI Chat Completions、OpenAI Responses 或 Anthropic Messages 发起第一条请求。以下示例只从环境变量读取 Key。

01 · SETUP

创建或获取 API Key

从 https://relai.vip/login 进入账户流程,创建或获取要用于请求的 API Key。不要把 Key 写入前端代码、公开仓库、日志或截图。

环境变量 / Environment
export RELAI_API_KEY="your-key-from-account"
export RELAI_BASE_URL="https://relai.vip/v1"
export RELAI_ANTHROPIC_BASE_URL="https://relai.vip"

02 · BASE URL

按请求格式选择入口

OpenAI-compatiblehttps://relai.vip/v1

Chat Completions:/chat/completions
Responses:/responses

Anthropichttps://relai.vip

Messages:/v1/messages

03 · REQUESTS

三种最小请求格式

OpenAI Chat Completions

POST https://relai.vip/v1/chat/completions
curl "$RELAI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $RELAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role": "user", "content": "Reply with one short sentence."}]
  }' 

OpenAI Responses

POST https://relai.vip/v1/responses
curl "$RELAI_BASE_URL/responses" \
  -H "Authorization: Bearer $RELAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "Reply with one short sentence."
  }' 

Anthropic Messages

POST https://relai.vip/v1/messages
curl "$RELAI_ANTHROPIC_BASE_URL/v1/messages" \
  -H "x-api-key: $RELAI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 64,
    "messages": [{"role": "user", "content": "Reply with one short sentence."}]
  }' 

04 · TROUBLESHOOTING

401、429 与 5xx 排错

401

检查 Key、Authorization / x-api-key 请求头与账户状态;401 不应自动重试。

429

采用有上限的指数退避,并记录请求 ID。

5xx

先保留响应与请求 ID,再做有限次数退避;不要重复提交可能已执行的写操作。

05 · LIMITS

兼容性边界

支持 OpenAI Chat Completions、OpenAI Responses 与 Anthropic Messages 三种请求入口。具体模型是否支持某一格式、参数、上下文长度或特定返回结构,必须以当前模型广场和真实请求结果为准。“OpenAI 兼容”不表示与官方 API 完全一致。

上线前检查

先验证鉴权、模型 ID、请求格式、错误码与超时处理,再接入生产流量。价格与分组可用性请查看登录后的模型广场。

FAQ

常见问题

OpenAI 兼容请求应使用哪个 Base URL?

以 https://relai.vip/v1 作为 Base URL。例如 Chat Completions 的完整路径是 https://relai.vip/v1/chat/completions。

Anthropic Messages 应使用哪个 Base URL?

Anthropic SDK 使用 https://relai.vip 作为 Base URL,Messages 请求路径为 https://relai.vip/v1/messages。

支持哪三种请求格式?

支持 OpenAI Chat Completions、OpenAI Responses 与 Anthropic Messages。具体模型是否支持某一种格式,必须以当前模型广场和实际请求结果为准。

“OpenAI 兼容”是否表示与官方 API 完全一致?

不表示完全一致。这里指请求入口遵循相应的接口格式;模型实现、路由、可用参数、上下文限制与返回结果仍可能不同。上线前请用目标模型做真实请求验证。

遇到 401、429 或 5xx 应如何处理?

401 应检查 Key、请求头与账户状态,不应自动重试;429 与 5xx 可采用有上限的指数退避并记录请求 ID。不要反复提交可能已执行的写操作或工具调用。