API 接口文档

欢迎使用 AI 中转服务 API。本接口完全兼容 OpenAI API 格式，您可以直接使用 OpenAI 官方 SDK 或任何支持 OpenAI 格式的客户端进行调用。

📖 简介

本服务提供标准的 OpenAI 兼容接口，您只需修改 base_url 和 api_key 即可无缝切换。

base_url: https://api.55.al/v1
api_key: sk-xxxxxxxxxxxxxx

🔑 认证方式

所有 API 请求都需要在 HTTP Header 中携带 API Key：

Authorization: Bearer sk-xxxxxxxxxxxxxx

您可以在控制台的“令牌”页面创建和管理 API Key。

🌐 Base URL

环境	Base URL
生产环境	`https://api.55.al/v1`
备用地址	`https://api.55.al/v1`

📋 列出模型

GET /v1/models

返回当前可用的模型列表。

📤 请求示例

curl https://api.55.al/v1/models \
  -H "Authorization: Bearer sk-xxxxxx"

📥 响应示例

{
  "object": "list",
  "data": [
    {"id": "deepseek-chat", "object": "model", "owned_by": "deepseek"},
    {"id": "deepseek-r1", "object": "model", "owned_by": "deepseek"}
  ]
}

💬 对话补全

POST /v1/chat/completions

创建对话补全，支持流式和非流式输出。

📋 请求参数

参数	类型	必填	说明
`model`	string	✅	模型名称，如 `deepseek-chat`
`messages`	array	✅	对话消息列表
`stream`	boolean	❌	是否流式输出，默认 false
`temperature`	float	❌	采样温度，0-2，默认 1.0
`max_tokens`	int	❌	最大输出 token 数

📤 请求示例

curl https://api.55.al/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "system", "content": "你是一个 helpful assistant"},
      {"role": "user", "content": "你好，请介绍一下自己"}
    ],
    "stream": false
  }'

📥 响应示例

{
  "id": "chatcmpl-xxxxx",
  "object": "chat.completion",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "你好！我是 DeepSeek..."},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 20, "completion_tokens": 50, "total_tokens": 70}
}

🤖 支持的模型（仅列出部分供说明使用，详见模型广场）

模型名称	说明	上下文长度
`deepseek-chat`	DeepSeek-V3 标准对话模型	128K
`deepseek-r1`	DeepSeek-R1 深度推理模型，展示思考链	128K

💰 计费说明

模型	输入价格	输出价格
`deepseek-chat`	$0.14 / 1M tokens	$0.28 / 1M tokens
`deepseek-r1`	$0.14 / 1M tokens	$0.28 / 1M tokens

计费单位为美元，按实际消耗 Token 数扣费。Token 数统计包含输入和输出。

⚠️ 错误码

HTTP 状态码	错误类型	说明
401	`invalid_api_key`	API Key 无效或已过期
402	`insufficient_quota`	账户余额不足
404	`model_not_found`	指定的模型不存在
429	`rate_limit_exceeded`	请求频率超限
500	`internal_server_error`	服务器内部错误

错误响应示例

{
  "error": {
    "message": "Insufficient quota. Please recharge.",
    "type": "insufficient_quota",
    "code": 402
  }
}