快速开始

Trellis AI 是一个私人学习技术的网站，为家人和少数爱好AI技术的朋友提供本地部署的模型 API，网站中的聊天对话功能仅用于体验和测试API的可用性。四步即可开始：注册 → 充值（虚拟充值） → 创建 API Key → 在应用中接入API。

1. 注册账号

访问网站首页，点击「登录」进入登录页，使用邮箱注册账号。本网站采用人工审核制，注册后需等待管理员审核后方可登录。

2. 充值

登录后进入「充值」页面，选择金额提交充值申请。管理员审核通过后，虚拟金额会充值到你的账户（本平台为内部学习研究用途，不涉及真实资金）。

3. 创建 API Key

进入「API Keys」页面，点击「创建 API Key」，输入名称即可。注意：完整 Key 只显示一次，请立即保存。

4. 发起第一个请求

curl https://api.trellis.hk/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-flash",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": false
  }'

5. 查看用量

在「用量信息」页面可查看余额、消费金额、请求次数与各模型用量明细。

鉴权

所有接口通过 HTTP 请求头的 Authorization 字段鉴权，格式为 Bearer 后跟你的 API Key。

Authorization: Bearer sk-xxxxxxxx

Base URL

接口基础地址为 https://api.trellis.hk/v1。 注意：示例域名可能随部署调整，以实际部署为准。

流式 vs 非流式

设置 "stream": true 开启流式响应（SSE）， 逐段返回内容；设为 false 则一次性返回完整结果。

错误处理

接口出错时返回非 2xx 状态码，并附带 JSON 错误信息。

{"error":{"message":"Invalid API key supplied","type":"invalid_request_error","code":"invalid_api_key"}}

可用模型

各模型的输入/输出类型、同步或异步、价格见「模型」页；具体调用方式见「API 指南」与「API 文档」。 也可通过 GET /v1/models 查看。