API 概览
LAYSO AI 提供统一网关，同时兼容 OpenAI、Anthropic、Gemini 与视频任务接口。一个 API Key 可以访问全平台模型，可按项目需要选择协议、SDK 与模型。
统一访问与透明计费
请求按所选模型的当前价格计费。每个成功请求都可以在用量日志中查看扣费明细；失败任务不会产生扣费。
基础配置
| 配置项 | 值 |
|---|---|
| API 请求地址 | https://api.layso.ai |
| 用户端网站 | https://layso.ai |
| OpenAI SDK Base URL | https://api.layso.ai/v1 |
| Anthropic SDK Base URL | https://api.layso.ai |
| API Key | 在 LAYSO AI 令牌管理页面创建 |
| OpenAI 鉴权 | Authorization: Bearer $LAYSO_API_KEY |
| Anthropic 鉴权 | x-api-key: $LAYSO_API_KEY |
| Gemini 鉴权 | x-goog-api-key: $LAYSO_API_KEY |
保护你的密钥
API Key 只能保存在服务端或安全的环境变量中，不要写入浏览器代码、公开仓库、截图或日志。
可用端点
OpenAI 兼容协议
| 端点 | 方法 | 说明 |
|---|---|---|
/v1/chat/completions | POST | 创建对话补全 |
/v1/responses | POST | 创建模型响应（推荐用于新项目） |
/v1/embeddings | POST | 创建文本向量 |
/v1/images/generations | POST | 创建图像 |
/v1/models | GET | 列出可用模型 |
/v1/models/{provider}/{model_id} | GET | 获取指定模型详情 |
/v1/models/count | GET | 获取模型数量 |
Anthropic 原生协议
| 端点 | 方法 | 说明 |
|---|---|---|
/messages | POST | 创建 Messages 响应 |
/models | GET | 列出可用模型 |
/models/{provider}/{model_id} | GET | 获取模型详情 |
/models/count | GET | 获取模型数量 |
Gemini 原生协议
| 端点 | 方法 | 说明 |
|---|---|---|
/v1beta/models/{model}:generateContent | POST | 生成内容 |
/v1beta/models/{model}:streamGenerateContent | POST | 流式生成内容 |
/v1beta/cachedContents | POST | 创建显式缓存 |
/v1beta/models | GET | 列出可用模型 |
视频生成
| 端点 | 方法 | 说明 |
|---|---|---|
/v1/videos | POST | 创建异步视频任务 |
/v1/videos/{id} | GET | 查询任务状态与结果 |
/v1/videos/{id} | DELETE | 取消尚未完成的任务 |
LAYSO AI 平台
余额、充值记录与逐请求扣费明细目前通过控制台提供：
平台未公开余额查询 REST 端点，请不要在服务端依赖未文档化的内部接口。
最小调用示例
bash
curl https://api.layso.ai/v1/chat/completions \
-H "Authorization: Bearer $LAYSO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [{"role": "user", "content": "Hello"}]
}'选择哪套协议
| 使用场景 | 推荐协议 |
|---|---|
| OpenAI SDK、Codex、通用聊天应用 | OpenAI 兼容协议 |
| Claude SDK、Claude Code、Messages 工作流 | Anthropic 原生协议 |
| Gemini SDK、Generate Content、显式缓存 | Gemini 原生协议 |
| 文生视频、图生视频与异步任务 | 视频生成接口 |