API 概览

本平台提供与 OpenAI 官方协议完全兼容的统一 API，聚合对话、补全、向量化、图像、音频、视频等多模态能力。

Base URL

https://api.idreame.com/v1

鉴权

所有接口通过请求头中的 Bearer Token 进行鉴权：

Authorization: Bearer sk-xxxxxxxx

详见鉴权与令牌。

接口列表

接口	方法	说明
/v1/models	GET	获取可用模型列表
/v1/chat/completions	POST	对话补全（核心接口）
/v1/embeddings	POST	文本向量化
/v1/images/generations	POST	文生图
/v1/images/edits	POST	图像编辑（图生图）
/v1/audio/speech	POST	语音合成（TTS）
/v1/audio/transcriptions	POST	语音识别（STT）
/v1/videos	POST	视频生成（异步）

其他协议格式

除 OpenAI 格式外，网关还原生支持以下协议，同一个 sk-… 令牌通用：

协议	端点	说明
Claude Messages	POST /v1/messages	Anthropic 原生消息格式，供 Claude SDK 直连
Gemini	POST /v1beta/models/{model}:generateContent	Google Gemini 原生格式（含流式）
Realtime	WS /v1/realtime	WebSocket 实时语音双向流

响应格式

成功响应返回 JSON，结构与 OpenAI 官方完全一致。
错误响应结构：

{
  "error": {
    "message": "错误描述",
    "type": "invalid_request_error",
    "code": "model_not_found"
  }
}

详见错误码。

速率限制

请求频率过高时，服务返回 429 Too Many Requests。建议：

• 对重试逻辑添加指数退避（如 1s → 2s → 4s）
• 对批量请求使用并发控制，避免瞬时峰值