开发者接入

Sprelay API 在同一个域名下提供多种协议。优先沿用项目已经使用的官方 SDK 或请求格式，只替换 Base URL、API 密钥和模型名称。

选择协议

协议	典型用途	文档
OpenAI Chat Completions	聊天、客户端、现有 OpenAI SDK	Chat Completions
OpenAI Responses	新式代理、统一输入、Codex	Responses
Anthropic Messages	Claude SDK、Claude Code	Claude Messages
Gemini Native	Gemini SDK 与原生内容结构	Gemini Native
图片生成	`gpt-image-2`、OpenAI 兼容图片请求	图片生成

接入原则

从环境变量读取密钥。
使用明确的连接和响应超时。
先完成非流式最小请求。
再启用流式输出、工具调用和复杂上下文。
记录请求时间、模型、状态码和站点返回的请求标识，但不要记录完整密钥或敏感提示词。

Base URL 总览

场景	地址
OpenAI SDK / Chat / Responses	`https://sprelaytoken.com/v1`
Claude SDK	`https://sprelaytoken.com`
Gemini 原生 SDK	`https://sprelaytoken.com`
完整 Chat 端点	`https://sprelaytoken.com/v1/chat/completions`
完整图片生成端点	`https://sprelaytoken.com/v1/images/generations`

推荐验证链路

text

GET /v1/models
  → 最小非流式请求
  → 流式请求
  → 工具调用
  → 业务负载与重试

当最小请求失败时，不要直接增加重试。先根据状态码定位配置问题，详见API 错误码。

API Reference

需要查看请求字段和响应 Schema 时，打开只读 API Reference。规范只包含已确认公开的中转接口，不包含后台管理接口。