快速开始

本指南帮助你在 3 分钟内接入 LAYSO AI Gateway，开始调用全球主流 AI 模型。

前置要求

登录 LAYSO AI 控制台获取 API Key
准备开发环境（Python 3.8+ / Node.js 18+）

统一接入

LAYSO AI 兼容 OpenAI、Anthropic 与 Gemini 三大协议，你可以使用熟悉的 SDK 或 HTTP 客户端接入。

选择接入方式

API 请求地址为 https://api.layso.ai；用户端网站为 https://layso.ai，用于登录、管理 API Key 和查看用量。使用 OpenAI SDK 时，Base URL 填写 https://api.layso.ai/v1。

OpenAI 兼容协议 — 最通用的接入方式。

终端

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": "用一句话介绍 LAYSO AI"}
    ]
  }'

验证响应

请求成功后会返回对应协议的标准响应。请先确认响应内容，再将调用加入业务代码。

遇到 401 时，检查 API Key 和请求头格式
遇到 403 时，检查模型 ID、API Key 和账户状态
遇到 429 时，降低并发并使用指数退避重试

下一步

在「认证指南」中了解 API Key 的安全保存方式
在「模型目录」中查询当前账户可调用的真实模型 ID
通过「流式响应」改善长文本生成的等待体验
为生产环境配置超时、重试与供应商故障回退

快速开始 ​

前置要求 ​

选择接入方式 ​

验证响应 ​

下一步 ​

快速开始

前置要求

选择接入方式

验证响应

下一步