API 指南

鉴权

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

Authorization: Bearer sk-xxxxxxxx

Base URL

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

错误处理

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

状态码含义
400请求参数错误(如模型不存在)
401API 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-flashDeepSeek V4 Flash(文本生成)128K8K tokens

可通过 GET /v1/models 查看。 多模态理解、文生图、文生视频、语音识别/合成等能力目前仅在站内「聊天对话」中使用,详见「产品定价」页。