文本模型 API

先按五分钟接入创建 DGlink API Key，并从模型目录复制精确模型 ID。只有模型资料确认支持 openai 聊天端点时才使用本示例。

curl "$DEELINK_API_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $DEELINK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <本次请求的唯一编号>" \
  -d '{
    "model": "<支持聊天端点的模型 ID>",
    "messages": [{"role": "user", "content": "你好，请简短介绍你的能力"}],
    "max_tokens": 256,
    "stream": false
  }'

DEELINK_API_BASE_URL 已包含 /v1。调用成功后，响应中的 choices[0].message.content 是文本结果，usage 给出 Token 用量。流式调用可设置 "stream": true，但应先用非流式请求验证渠道与模型可用性。

模型按实际输入/输出 Token 计费；输入与输出美元费率见价格页，真实额度扣减见客户控制台。不要把按次图像/视频模型提交到聊天端点。若接口返回不支持的参数或端点，请检查该模型的资料页和已开通渠道，而不是只更换展示名称。

网页 Playground 参数子集

登录后的同源 POST /api/deelink/playground/run 接受 { "modelId": "<已发布目录 ID>", "requestId": "<UUID>", "parameters": { "prompt": "你好", "max_tokens": 16 } }。目录 ID 不是上游型号名；服务端检查已发布售价与可用渠道后选择型号。

表单与 JSON 共用服务端模型限制。Gemini 当前默认允许最多32768个 UTF-8 字节的提示词（中文通常每字3字节）；max_tokens 默认2048、最大8192，管理员可调整，商业安全闸门可能进一步降低上限。以模型页显示的生效配置为准。网页固定非流式输出，经客户 Gateway 凭据实际计费；客户 API 另支持下文的消息数组与 SSE。Gemini 2.5 Flash 的表单和 JSON 已开放下表的可选采样参数及停止词。网页暂不开放任意 messages、系统指令、工具及客户端自选型号/计费字段。本子集不适用于 Anthropic 或 Gemini 原生协议。

参数	当前契约
`max_tokens`	整数，受后台当前输出上限约束；网页和 API 都可用
`max_completion_tokens`	客户 API 的兼容别名，规范化为 `max_tokens`；不能同时传两个字段
`temperature`	Gemini 2.5 Flash：0–2 的数值，可省略；0 会原样传递
`top_p`	Gemini 2.5 Flash：0–1 的数值，可省略；通常只调温度或核采样中的一个
`stop`	Gemini 2.5 Flash：1个字符串或1–4个字符串的数组，每个1–256个 UTF-8 字节；表单每行一个

可选项留空时不发送，使用上游默认行为；显式 null、越界、未知字段及未定价的 n/tools 会在扣费前拒绝。停止词不会去掉前后空白。参数规范化后参与幂等校验，因此输出长度别名或单个停止词的两种合法表示不会意外发起第二次调用。

API 示例反映当前有效参数；无效 JSON 不会复制成旧请求。超时不代表未扣费，重试前先查用量。

Gemini 分档计费测试通道

这是需要管理员单独启用价格版本的有限测试通道，不代表所有文本、多模态模型均已完成实扣验收。未启用时不会自动放开目录。

目前适配代码包含 gemini-2.5-flash 和 gemini-3.8-flash。新增的 Gemini 3.8 Flash 只完成本地模拟校验，未自动上架，也未在本轮使用真实算力验收；必须核实渠道、上游缓存用量字段及独立价格版本。其接口暂不开放 temperature/top_p/stop，消息不能以 assistant 结束。EvoLink 的 Gemini 3.8 说明提醒 Gemini 3.x 的采样配置可能被接受但忽略，因此界面不显示无实际效果的调节项。

管理员在“文本模型限制”选择型号，分别管理限制；这不会启用收费。激活价格使用 Gateway 环境变量 DEELINK_TEXT_PRICE_REVISIONS，例如 {"gemini-3.8-flash":"<已审核且已保存的价格版本>"}。每个版本必须包含该型号普通/VIP两档的输入、输出、缓存读取六条价格规则。旧 DEELINK_GEMINI_TEXT_PRICE_REVISION 继续兼容；同型号配置冲突会拒绝请求。修改容器环境后需重建 Gateway。缺失价格或渠道不能靠修改展示状态解决。

启用后，gemini-2.5-flash 在 /v1/chat/completions 支持普通响应和 SSE。默认最多64条纯文本消息、内容合计32768个 UTF-8 字节、max_tokens 1–8192（省略时2048），上游等待上限180秒。以上均由后台“文本模型限制”按模型配置；并非上游理论能力上限。输入预扣预算为允许字节数×4，不是实际 Token 用量。不接受图片、音频、工具、联网搜索或其他未定价参数。Idempotency-Key 必填，同一编号只能用于同一请求；重复提交返回409和原请求状态，不再次调用上游，文本内容不会为重放而保存。

先冻结一笔覆盖受限输入和最大输出的额度；成功后按真实输入、输出、缓存命中用量及提交时的普通/VIP档位结算，多余预扣返还。正常完成的流式响应在结算后才发送 [DONE]。缓存用量缺失、响应中断或上游结果不确定时，保留预扣并标记待核对，不自动退款或重试。

保存响应头 X-Deelink-Request-ID，可使用同一账户的 API Key 查询：

curl "$DEELINK_API_BASE_URL/deelink/text-requests/<请求编号>" \
  -H "Authorization: Bearer $DEELINK_API_KEY"

reserved 是预扣待结算，succeeded 是已结算，refunded 是明确失败后的已退款；reserved_quota 为原预扣额度，charged_quota 为最终扣费。账单单位是 Gateway quota，不是上游 Credits。

管理员可在“异常账单核对”查看请求与审计：已有可信用量时重试结算；用量缺失时按上游凭证补齐输入、输出、缓存用量；确认失败且无成功证据时退回预扣。创建不足10分钟的请求禁止人工操作。每次处理必须填写凭证编号和原因，并与资金变动原子保存；同一操作编号重试不重复扣退。成功账单不能从这里退款，客户退款也不代表上游成本为零。后台修改限制不会重新计算已提交请求。

文本模型 API

网页 Playground 参数子集

Gemini 分档计费测试通道

On this page