API 快速入门

ama 企业AI网关提供完全兼容 OpenAI 格式的 API 接口，一个 API Key 即可访问 50+ 主流AI模型。

快速开始

只需 3 步即可开始使用 ama API：

1
注册账号
访问控制台完成注册，支持手机号/邮箱登录
→
2
获取 API Key
在控制台 → API Keys 页面创建密钥
→
3
开始调用
使用下方示例代码发起第一个请求

Base URL

https://l288.com/v1

认证方式

所有 API 请求都需要通过 HTTP Header 传递 API Key 进行认证。在请求头中添加 Authorization 字段：

HTTP Header 
Authorization: Bearer YOUR_API_KEY

curl 认证示例

bash 
curl https://l288.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"
请妥善保管您的 API Key，不要在客户端代码中明文暴露。建议通过环境变量或密钥管理服务存储。

兼容接口

ama 完全兼容 OpenAI API 格式，您可以使用 OpenAI 官方 SDK 或任何兼容的第三方库直接接入，无需修改业务代码。

方法 端点 说明
POST /v1/chat/completions 对话补全
POST /v1/completions 文本补全
POST /v1/embeddings 向量嵌入
POST /v1/images/generations 图像生成
POST /v1/audio/transcriptions 语音转文字
GET /v1/models 模型列表
只需将 base_url 从 https://api.openai.com/v1 替换为 https://l288.com/v1 即可无缝迁移。

对话补全示例

以下是一个完整的对话补全请求示例：

请求

bash 
curl https://l288.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [{"role": "user", "content": "你好，请介绍一下你自己"}],
    "temperature": 0.7
  }'

响应

json 
{
  "id": "chatcmpl-abc123def456",
  "object": "chat.completion",
  "created": 1717027200,
  "model": "deepseek-v4-pro",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好！我是DeepSeek，一个由深度求索开发的AI助手..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 86,
    "total_tokens": 104
  }
}

Python SDK

推荐使用 OpenAI 官方 Python SDK，只需修改 base_url 即可接入：

python 
from openai import OpenAI

# 初始化客户端，指向 ama 网关
client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://l288.com/v1"
)

# 发起对话请求
response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[
        {"role": "user", "content": "你好"}
    ]
)

print(response.choices[0].message.content)

安装依赖

bash 
pip install openai
支持 OpenAI SDK v1.0+ 版本。Node.js 开发者同样可以使用 openai npm 包，配置方式类似。

流式输出 (Streaming)

通过设置 "stream": true 启用 SSE (Server-Sent Events) 流式输出，适合对话界面逐字显示场景：

bash 
curl https://l288.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro",
    "stream": true,
    "messages": [{"role": "user", "content": "讲一个故事"}]
  }'

Python 流式示例

python 
stream = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[{"role": "user", "content": "讲一个故事"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")
流式响应的每个 chunk 以 data: {...} 格式返回，结束标志为 data: [DONE]。

模型列表

ama 支持 50+ 主流AI模型，以下为热门模型分类：

对话模型

deepseek-v4-pro deepseek-r1 glm-5.1 qwen-max kimi-k2-6 doubao-seed-2-0-pro

图像模型

flux-pro gpt-image-1

嵌入模型

text-embedding-3-large bge-large-zh
调用 GET /v1/models 获取完整且实时的模型列表。新模型上线后会自动更新。

错误码

当请求出现异常时，API 会返回标准 HTTP 状态码及错误信息：

状态码 说明 常见原因
400 请求参数错误 请求体格式不正确、缺少必填参数
401 认证失败 API Key 无效或未提供
403 权限不足 账户余额不足或模型未授权
429 请求频率超限 超出当前套餐的速率限制
500 服务器内部错误 网关内部异常，请稍后重试
502 上游模型服务不可用 模型提供方暂时故障

错误响应示例

json 
{
  "error": {
    "message": "Invalid API key provided",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

费用说明

ama 采用按量计费模式，输入 token 和输出 token 分别计价，不同模型价格不同。具体价格请查看模型广场。

余额查询

bash 
curl https://l288.com/api/user/quota \
  -H "Authorization: Bearer YOUR_API_KEY"

充值方式

登录控制台 → 钱包 → 充值，支持支付宝、微信等方式。

每次 API 调用的实际费用可在响应的 usage 字段中查看 token 用量。我们不会收取任何隐藏费用。

更多帮助

如果您需要更详细的技术支持或完整的 API 参考文档：

📖
完整 API 文档
登录后访问控制台 → API文档，查看 Swagger 交互式文档
🎧
技术支持
登录控制台提交工单，工作日 24 小时内响应
💼
商务合作
企业定制需求请联系
4008036@qq.com