API 指南 / DeepSeek Flash（V4.1）

API 指南 · DeepSeek Flash（V4.1）

对话补全（OpenAI 兼容）：DeepSeek V4.1 Flash；上下文名义 1M，实际上限以 `GET /v1/models` 的 `max_model_len` 为准；支持函数调用；图片理解需服务端开启。

使用 OpenAI 兼容协议：请求头带 Authorization: Bearer <你的API Key>，请求体为 model + messages。

设置 stream: true 可开启 SSE 流式返回，逐段拿到增量内容，直到 [DONE] 结束。

上下文：名义 1M；实际上限请读取 GET /v1/models 的 max_model_len（会随部署调整，客户端请在启动时读取，勿写死）。

并发/排队：以服务端当前配置为准；单请求排队超时可用请求头 X-Trellis-Queue-Timeout: <秒> 覆盖（0=不等待）。

多模态（`VISION` 开关）：模型具备图片理解，但实际部署可能关闭（服务端 VISION=0）。是否开启以 GET /v1/models 的 vision 字段为准（若网关未返回该字段，则以实际请求为准：带图返回 400 image input requires ... 即表示关闭）。开启后 messages[].content 可传文本 + 图片（image_url：URL 或 data-uri）。

503 处理：E_QUEUE_FULL / E_QUEUE_TIMEOUT / E_BACKEND_NOT_READY 请遵守响应的 Retry-After 退避重试；409 E_MODE_MISMATCH 不要重试。

稳定 id：模型名固定为 deepseek-flash（版本升级不改名）；老 id deepseek-v4-flash 作为兼容别名，等价可用。

计费按 token，用量来自响应里的 usage（prompt_tokens / completion_tokens）。

调用示例：

cURL

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
  }'

Python

from openai import OpenAI

client = OpenAI(api_key="sk-xxxxxxxx", base_url="https://api.trellis.hk/v1")

completion = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{"role": "user", "content": "你好"}],
    stream=False,
)
print(completion.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({ apiKey: "sk-xxxxxxxx", baseURL: "https://api.trellis.hk/v1" });

const completion = await client.chat.completions.create({
  model: "deepseek-flash",
  messages: [{ role: "user", content: "你好" }],
  stream: false,
});
console.log(completion.choices[0].message.content);

cURL（图片理解；需服务端开启 VISION）

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":[
      {"type":"image_url","image_url":{"url":"https://example.com/a.png"}},
      {"type":"text","text":"这张图里有什么？"}
    ]}]
  }'

查看 API 文档模型信息与价格

所有模型共用同一 API Key 与同一端点：https://api.trellis.hk/v1