五分钟接入

1. 准备账户与模型

先确认账户有可用额度。进入 API 密钥 创建密钥，并在创建时保存完整明文；之后列表只显示掩码。如果密钥显示“同步失败”或“同步中”，先在控制台重试同步，不要直接调用。

在 模型目录 中选择已上架的模型。详情中的“调用模型 ID”必须逐字复制；模型显示名不是请求参数。目录按现有商业定价区分 Token 与按次计费，不代表每个模型都支持聊天端点。

2. 配置 Base URL

DEELINK_API_BASE_URL 表示包含 /v1 的 API 地址，不是网站首页，也不是上游 EvoLink 地址。以下本地例子要求 Gateway 正在 3001 端口运行；正式部署请使用控制台显示的地址。

export DEELINK_API_BASE_URL="http://localhost:3001/v1"
export DEELINK_API_KEY="<创建时保存的 DGlink API Key>"

先验证鉴权及可访问模型：

curl "$DEELINK_API_BASE_URL/models" \
  -H "Authorization: Bearer $DEELINK_API_KEY"

3. 发起一条文本请求

仅当你选择的模型支持 OpenAI 兼容的聊天端点时，才使用下面的例子。把 <精确模型 ID> 替换为该模型详情中的调用 ID；不要把图片、视频等按次模型直接套进此请求。

curl "$DEELINK_API_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $DEELINK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <本次新请求的唯一 UUID>" \
  -d '{
    "model": "<精确模型 ID>",
    "messages": [{"role": "user", "content": "请只回复：连接成功"}],
    "max_tokens": 64,
    "stream": false
  }'

成功后，可在客户控制台查看额度和调用记录。价格页中的模型美元费率与人民币充值额度是不同概念；最终扣减以实际结算记录为准。若遇到 401，先检查 Key 是否同步成功；若遇到模型或端点错误，核对模型 ID、渠道和该模型支持的接口。

每个新请求使用一个新 UUID；结果不明时先查询原请求，不要换编号再次生成。当前 Gemini 分档路径必须有幂等头，重复提交返回 409 而不是重新返回文本。SDK 默认重试也应关闭。参见 SDK 接入 和 当前能力范围。