API 指南
鉴权
所有接口通过 HTTP 请求头的 Authorization 字段鉴权,格式为 Bearer 后跟你的 API Key。
Authorization: Bearer sk-xxxxxxxxBase URL
接口基础地址为 https://api.trellis.hk/v1。 注意:示例域名可能随部署调整,以实际部署为准。
错误处理
接口出错时返回非 2xx 状态码,并附带 JSON 错误信息。
| 状态码 | 含义 |
|---|---|
| 400 | 请求参数错误(如模型不存在) |
| 401 | API Key 无效或缺失 |
| 402 | 余额不足 |
| 403 | 账户被封禁 |
| 502 | 上游服务不可用 |
{"error":{"message":"Invalid API key supplied","type":"invalid_request_error","code":"invalid_api_key"}}流式 vs 非流式
设置 "stream": true 开启流式响应(SSE), 逐段返回内容;设为 false 则一次性返回完整结果。
支持的模型
当前通过 API 网关(/v1)开放的模型:
| 模型 ID(model) | 说明 | 上下文长度 | 最大输出 |
|---|---|---|---|
deepseek-v4-flash | DeepSeek V4 Flash(文本生成) | 128K | 8K tokens |
可通过 GET /v1/models 查看。 多模态理解、文生图、文生视频、语音识别/合成等能力目前仅在站内「聊天对话」中使用,详见「产品定价」页。