网关端点

网关地址：https://api.allenyeahger.xyz

所有网关请求都需要 API Key，通过请求头传递：

Authorization: Bearer sk-your-key

Gemini 兼容接口部分客户端使用 x-goog-api-key，若你的渠道走 Gemini 原生协议需按客户端要求调整。

确定支持

方法	路径	用途
GET	/v1/models	获取当前密钥可见的模型列表
POST	/v1/chat/completions	OpenAI Chat Completions 兼容请求
POST	/v1/responses	OpenAI Responses 兼容请求
POST	/v1/messages	Anthropic Messages 兼容请求
POST	/v1/messages/count_tokens	计算 Messages 请求 Token

取决于渠道与版本

以下端点需要网关版本与上游渠道同时支持，以你控制台实际测试结果为准：

方法	路径	用途
POST	/v1/embeddings	创建向量嵌入
POST	/v1/images/generations	生成图像
POST	/v1/images/edits	编辑图像
POST	/v1/audio/speech	文本转语音
POST	/v1/audio/transcriptions	语音转文本
GET	/v1beta/models	Gemini 原生模型列表
POST	/v1beta/models/{model}:generateContent	Gemini 原生生成内容

快速验证某个端点是否可用

直接发一条最小请求，404 表示当前不支持，401 表示端点存在但密钥有问题：

curl -i https://api.allenyeahger.xyz/v1/embeddings \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"your-model-id","input":"test"}'

鉴权

curl https://api.allenyeahger.xyz/v1/models \
  -H "Authorization: Bearer sk-your-key"

• Authorization 头的值必须以 Bearer 开头（Bearer 后一个空格）。
• 密钥只在控制台创建时完整显示一次。
• 密钥可单独设置额度上限、过期时间、模型限制与 IP 白名单。

流式

Chat Completions 加 "stream": true，响应为 SSE：

curl -N https://api.allenyeahger.xyz/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "stream": true,
    "messages": [{"role":"user","content":"写一句自我介绍"}]
  }'

curl 记得加 -N 关闭缓冲，否则看不到打字机效果。

关于 /v1 重复

这是最常见的 404 原因。规则：请求路径中只能出现一次 /v1。

Base URL	客户端拼接	最终路径	结果
https://api.allenyeahger.xyz	/v1/chat/completions	/v1/chat/completions	✅
https://api.allenyeahger.xyz/v1	/chat/completions	/v1/chat/completions	✅
https://api.allenyeahger.xyz/v1	/v1/chat/completions	/v1/v1/chat/completions	❌ 404