兼容 OpenAI SDK · 统一 API 接口

蓝莓岛开发手册 · 使用教程

支持多家主流模型，10 分钟完成接入，快速上线你的 AI 应用。只需替换base_url与model即可在现有工程中使用。

1. 基础信息

基础地址（Base URL）

https://api.lmdone.com/v1

请求头（Headers）

AuthorizationBearer <YOUR_API_KEY>

Content-Typeapplication/json

2. 前置准备

在控制台创建并保存 API Key；
确认账户余额/额度可用；
了解计费与限流规则（QPS、并发、超时）。

3. 安装依赖

Python

pip install openai

Node.js

npm i openai
# 或 pnpm add openai / yarn add openai

4. 选择模型

模型标识（示例：qwen2.5-7b-instruct / glm-4-flash / mistral-nemo）

GET /models

* 通过 GET /models 查询当前可用模型与标识；示例中的your-model-id请替换为你开通的模型。

5. 最小可用示例

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.lmdone.com/v1",
)

resp = client.chat.completions.create(
    model="your-model-id",
    messages=[{"role":"user","content":"给我一个两行的中文笑话"}],
    temperature=0.7,
    max_tokens=256,
)
print(resp.choices[0].message.content)

6. 常用接口

接口	方法	说明	关键参数
/chat/completions	POST	对话生成（OpenAI 兼容）	model, messages, temperature, max_tokens, top_p
/completions	POST	文本补全	model, prompt, max_tokens
/embeddings	POST	文本向量	model, input
/models	GET	模型列表	—
/usage	GET	用量/计费	start_date, end_date

注：具体字段与默认值以平台正式文档为准；此处仅展示 OpenAI 兼容形态。

7. 常见错误与排错

401：API Key 缺失/无效 → 检查鉴权头；
403：无权限/未开通 → 检查套餐或白名单；
404：路径或模型名错误 → 校验 model 与 URL；
429：限流 → 降并发并采用指数退避重试；
5xx：服务端异常 → 记录 request_id 并重试或联系支持。

8. 最佳实践

固定系统提示词 + 结构化输入（提示词工程）；
设置超时（10–30s）与重试（指数退避）；
缓存稳定入参；长输入分片重试；
服务端代理调用并妥善保管密钥；开启日志与监控；
固定模型/参数版本，变更需回归测试。