API 文档

兼容 OpenAI 格式的 AI API 网关，支持文本生成、代码、图片等多种模型。

快速开始

只需三步即可接入：

1. 在控制台创建 API 密钥

2. 选择模型（如 deepseek-v4-flash）

3. 发送请求

curl https://trelayai.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "你好！"}]
  }'

认证方式

所有 API 请求均需在 HTTP Header 中携带 API 密钥：

Authorization: Bearer sk-your-api-key

密钥可在控制台 → Token 中创建和管理。

🔐 安全提示

请勿将 API 密钥暴露在客户端代码或公开仓库中。如密钥泄露，请立即在控制台中删除并重新生成。

Chat Completions

兼容 OpenAI /v1/chat/completions 接口标准。

POST/v1/chat/completions

请求参数

参数	类型	必填	说明
`model`	string	是	模型 ID，如 `deepseek-v4-pro`
`messages`	array	是	对话消息数组，支持 system/user/assistant 角色
`temperature`	number	否	采样温度 0-2，默认 1
`max_tokens`	integer	否	最大输出 token 数
`top_p`	number	否	核采样参数 0-1
`stream`	boolean	否	是否启用流式输出，默认 false

代码示例

curl https://trelayai.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TRELAY_API_KEY" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "用一句话介绍你自己"}]
  }'

import requests

url = "https://trelayai.com/v1/chat/completions"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer sk-your-api-key"
}
data = {
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "你好！"}]
}
r = requests.post(url, headers=headers, json=data)
print(r.json()["choices"][0]["message"]["content"])

const response = await fetch("https://trelayai.com/v1/chat/completions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer sk-your-api-key"
  },
  body: JSON.stringify({
    model: "deepseek-v4-flash",
    messages: [{role: "user", content: "Hello!"}]
  })
});
const data = await response.json();
console.log(data.choices[0].message.content);

响应格式

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "model": "deepseek-v4-flash",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "你好！有什么可以帮你的？"
    },
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 8, "completion_tokens": 12, "total_tokens": 20}
}

流式响应

设置 stream: true 即可启用 SSE (Server-Sent Events) 流式输出：

curl https://trelayai.com/v1/chat/completions \
  -H "Authorization: Bearer $TRELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "讲个笑话"}],
    "stream": true
  }'

流式响应以 data: {...} 格式逐块推送，最后以 data: [DONE] 结束。

模型列表

GET/v1/models

获取当前可用的所有模型。

curl https://trelayai.com/v1/models \
  -H "Authorization: Bearer $TRELAY_API_KEY"

模型详情

以下为当前可用模型及建议使用场景：

deepseek-v4-pro

文本 · 高精度

deepseek-v4-flash

文本 · 快速低延迟

qwen3.8-max

文本 · 超长上下文

qwen3.8-flash

文本 · 快速推理

qwen3-coder-next

代码 · 编程辅助

kimi-k3

文本 · 长上下文

glm-5.2

文本 · 通用

qwen-image-3.0

图片 · 文生图

qwen-image-2.0-pro

图片 · 专业生成

wan2.7-image-pro

图片 · 高质量

错误码

状态码	错误类型	说明
`400`	invalid_request_error	请求参数有误
`401`	authentication_error	API 密钥无效或缺失
`402`	insufficient_quota	余额不足，请充值
`429`	rate_limit_exceeded	请求频率超限
`429`	monthly_budget_exceeded	月度预算已用完
`500`	internal_error	服务器内部错误

速率限制

为保障服务质量，API 设有速率限制：

📊 全局限制：每分钟最多 600 次请求

🔑 单 Key 限制：每 10 分钟最多 120 次请求

💡 超出限制将返回 429 状态码，请适当降低请求频率或添加重试逻辑。