L288 / DEVELOPER DOCUMENTATION

一个入口，
开始调用。

通过 l288 AI 网关接入账户当前可用的模型。这里提供开始开发所需的认证方式、基础调用和上线注意事项；模型能力、接口类型与实时价格以控制台展示为准。

BASE URLhttps://l288.com/v1

AUTHENTICATIONBearer API Key

FORMATOpenAI Compatible

01 / AUTHENTICATION

用 API Key 认证

登录控制台创建 API Key。每次请求都要在 HTTP Header 中携带密钥。密钥只会在创建时完整显示，请保存在服务端环境变量或密钥管理服务中。

HTTP HEADER

Authorization: Bearer YOUR_API_KEY

不要把 Key 放入网页、App 安装包或公开仓库。 如果怀疑泄露，请立即在控制台删除旧 Key 并重新创建。

02 / QUICKSTART

发送第一条请求

以下示例使用 OpenAI SDK。请将模型 ID 替换为你的账户在模型目录中实际可用的 ID。

PYTHON

from openai import OpenAI

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

response = client.chat.completions.create(
  model="MODEL_ID_FROM_CONSOLE",
  messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)

CURL

curl https://l288.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"MODEL_ID_FROM_CONSOLE","messages":[{"role":"user","content":"你好"}]}'

03 / MODELS & ENDPOINTS

先确认模型，再选择接口

不同模型可能支持不同接口与参数。接入前请在模型与价格页面复制准确的模型 ID，并查看模型详情。不要根据展示名称猜测 ID。

GEThttps://l288.com/v1/models

使用当前 API Key 查询其可见模型。返回结果受账户分组、密钥权限和当前配置影响。

项目	正确做法	说明
模型 ID	`从控制台复制`	目录可能随上游和账户权限变化
接口路径	`查看模型详情`	不要假设所有模型都使用同一接口
参数	`按模型能力传入`	不支持的参数可能被拒绝或忽略
价格	`以实时页面为准`	计费单位与账户分组可能不同

目录展示不等于实时健康状态。 正式上线前，请用你的真实输入、小流量和目标模型完成稳定性、延迟、输出质量与成本验证。

04 / IMAGE GENERATION

图片生成：先在工作台验证，再接入业务

图片工作台提供一个可视化的最小闭环；需要批量生成、自动化或接入业务系统时，直接调用图片生成接口。图片模型 ID、可用参数、价格和输出格式以当前控制台和模型详情为准。

POSThttps://l288.com/v1/images/generations

CURL

curl https://l288.com/v1/images/generations \
  -H "Authorization: Bearer $AMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_IMAGE_MODEL_ID",
    "prompt": "一张干净的商品视觉图，留出文案空间",
    "size": "1024x1024",
    "quality": "auto"
  }'

响应格式可能因模型和上游而不同。 常见结果包含 data[].b64_json 或 data[].url。正式接入前请用你的账户和目标模型完成一次真实请求，并为长耗时任务设置超时、重试上限和成本告警。

打开 ama 图片工作台 →

05 / ERRORS & RETRIES

按错误类型处理

状态	常见原因	建议处理
`400`	参数、模型或接口不匹配	检查请求体和模型详情，不要原样重试
`401`	Key 缺失、错误或失效	检查 Authorization Header 与 Key 状态
`403`	账户或模型权限不足	检查分组、额度和密钥权限
`429`	请求过快、额度或上游限制	降低并发，指数退避后重试
`5xx`	网关或上游暂时不可用	短暂退避，设置最大重试次数和降级方案

RETRY PSEUDOCODE

for attempt in range(MAX_RETRIES):
  response = call_api()
  if response.status not in [429, 500, 502, 503, 504]:
    break
  sleep(min(BASE_DELAY * 2 ** attempt + jitter(), MAX_DELAY))

为每次请求设置连接与读取超时，并记录请求时间、模型 ID、HTTP 状态和平台返回的请求标识。日志中不要保存完整 API Key。

06 / BILLING & LIMITS

以账户实时信息为准

模型价格、计费单位、余额、套餐、有效期和可用范围以控制台及下单页面实时展示为准。公开文档不固定承诺统一的 RPM、TPM、并发量、响应时间或可用性指标。

调用前

核对模型 ID、计费单位、适用分组和账户余额。

测试期

用真实输入测量成功率、延迟、质量和单次成本，设置预算上限。

上线后

查看用量与请求日志，监控 429、5xx、超时和异常成本增长。

07 / PRODUCTION CHECKLIST

上线前检查

Key 仅保存在服务端，并具备轮换和撤销方案。
模型 ID 与接口来自当前控制台，不在代码中依赖未经确认的别名。
设置超时、有限重试、指数退避和业务降级。
对 AI 输出进行校验，不把输出直接用于高风险决策。
建立用量和成本告警，避免循环调用或异常流量持续消耗。
对用户输入、日志和输出按业务需要实施隐私与合规控制。

需要帮助？ 请提供发生时间、模型 ID、接口路径、HTTP 状态码和脱敏后的错误信息。不要发送完整 API Key 或敏感业务数据。

一个入口，开始调用。