LLAI / DEVELOPER GUIDE

从第一条请求开始。

来啦 API（来啦 AI）提供统一的模型接入入口。对于支持 OpenAI Chat Completions 协议的模型，可以沿用 OpenAI SDK，将 Base URL、API Key 和模型 ID 替换为来啦账户的配置。

接入前，准备三个值

Base URL：https://llai.pro/v1，用于 OpenAI 兼容 SDK。
API Key：登录密钥管理创建密钥。为不同应用使用独立密钥。
模型 ID：从账户可用模型中复制准确的 ID。首页展示的模型系列名不能直接当作请求参数。

先查看模型价格目录，确认模型所属分组、支持能力和计费方式。GPT、Claude、Gemini、DeepSeek 等不同模型的参数兼容性可能不同。

发送第一条流式请求

在服务端安装 Python SDK：pip install openai。通过你的运行环境配置 LLAI_API_KEY 和 LLAI_MODEL 两个环境变量，然后运行：

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["LLAI_API_KEY"],
    base_url="https://llai.pro/v1",
)

stream = client.chat.completions.create(
    model=os.environ["LLAI_MODEL"],
    messages=[{"role": "user", "content": "你好，来啦！"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices:
        print(chunk.choices[0].delta.content or "", end="")

JavaScript、cURL 和 Go 示例可在首页代码区切换并复制。示例不包含真实密钥，也不会在浏览器中向模型发送请求。

不要将 API Key 放入浏览器脚本、前端构建变量或公开仓库。让你的服务端调用模型，再将业务结果返回前端。

不同能力，使用对应接口

文本对话使用所选模型支持的对话协议；图像、音频、Embedding 和 Responses 等能力有各自的接口和参数。OpenAI 兼容不等于所有模型支持所有端点，应先检查目标模型和账户权限，再逐步增加流式输出、工具调用或多模态输入。

接入 Claude Code 与 Codex

开发工具的协议与 SDK 示例可能不同。先确认账号分组允许使用对应工具和模型，再按工具文档配置。不要将 Chat Completions 示例直接当作所有工具的配置文件。

Claude Code

Claude Code 使用 Anthropic 协议。配置时关注服务地址、认证方式和模型权限，基础地址是否带 /v1 应遵循站点提供的 Anthropic 兼容配置，避免与客户端自动补全的路径重复。

Codex

Codex 需要选择正确的模型提供方、API 地址和协议，相关配置通常涉及 Responses 接口。模型名、接口权限与密钥分组应匹配。完成配置后先发起一个简短请求，确认认证和响应正常，再用于项目任务。

打开完整工具指南

常见错误怎么排查？

401：检查密钥是否有效、是否被撤销，以及认证头是否按目标协议传递。不要在日志里打印完整密钥。
403：检查账户、密钥分组和目标模型权限。不同分组可用模型可能不同。
404：检查 Base URL 是否重复添加 /v1，以及当前端点和模型 ID 是否正确。
429：检查额度或速率限制。按响应提示进行有限次数的退避重试，避免立即循环请求。
连接超时或上游错误：保存请求时间、模型 ID 和请求标识，结合控制台记录定位。设置合理超时，避免重复发送可能已经成功的高成本任务。
流式响应没有逐步显示：检查客户端是否逐块读取，以及自己的反向代理是否开启了响应缓冲。

核对用量与费用

文本模型通常按输入、输出、缓存等维度计费；图像或其他能力可能采用不同单位。实际费用由模型、分组和当前规则决定，不能仅用输入文字长度估算。

调用前查看价格，调用后在控制台核对请求记录与 Token 用量。首页介绍模型生态，不承诺固定的模型数量、价格、延迟或服务可用率。

进入控制台