DX API Gemini API 中转接入

先确定使用 Gemini 原生协议还是 OpenAI 兼容协议，再核对模型与所需能力。支持某个 Gemini 模型，不等于该分组已开放所有原生端点、多模态格式或工具功能。

先回答：现有程序需要哪种协议？

进入模型与价格，查看目标 Gemini 模型的协议和端点标记。如果现有程序或客户端使用 Gemini 原生格式，需要该分组明确支持对应的原生入口；如果使用 OpenAI Chat Completions 格式，则需要明确的兼容标记。不要仅凭模型名或一个通用 Base URL 判断两者可以互换。

你的程序使用	需要确认	不能据此推定
Gemini 原生协议	分组给出的原生端点、鉴权和请求格式。	所有 Gemini 原生方法均已支持。
OpenAI 兼容协议	模型标注兼容，以及支持的参数与返回格式。	Gemini 的每项原生能力都会完整映射。
仅知道模型名称	先查模型详情或向首页所列客服确认。	自行拼出端点后即可使用。

选定协议后再保存客户端配置。若同时修改协议、模型和请求字段，失败时很难区分是地址问题、格式问题，还是当前模型没有开放相应能力。

Base URL 只在对应协议下有意义

本页公开的 OpenAI 兼容 Base URL 是 https://api.dxlingxiapi.top/v1。它只用于控制台明确标注为兼容的模型；Gemini 原生入口应按该模型分组说明填写，不从 /v1 推导，也不把网站首页当作完整请求端点。

请求的 model 使用该分组列出的实际模型 ID。展示名称、客户端内置名称与本站模型 ID 未必相同；不要沿用其他服务商的名称映射。核对令牌权限、分组、余额和限制后，再发起第一次请求。

如果客户端自动追加路径，检查最终请求是否重复出现版本前缀。原生模式的鉴权与参数应与该模式对应，不能把兼容示例的头部和正文照搬到未知原生端点。

从单轮文本请求验证基础配置

仅在已确认 OpenAI 兼容时，可以采用下列格式。将 API_KEY 和 MODEL_ID 替换为自己的配置；本页不指定模型版本，也不把示例描述为实测结果。

curl --request POST \
  "https://api.dxlingxiapi.top/v1/chat/completions" \
  --header "Authorization: Bearer API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "MODEL_ID",
    "messages": [
      {"role": "user", "content": "请列出整理会议纪要的三个步骤。"}
    ],
    "stream": false
  }'

先确认状态码、文本内容和控制台用量记录，再把同一组地址、模型和令牌填入客户端。原生模式应使用该分组的原生示例，不以这个兼容请求验证原生协议已经可用。客户端配置入口见新手接入。

图片、文件与工具要分别确认

Gemini 家族包含不同能力的模型，不能把家族层面的能力当作某个中转分组的承诺。在准备发送图片、文件或工具定义前，先核对目标模型和端点是否明确支持；未列出的能力先确认，不通过反复发送复杂请求来猜测。

确认模型详情允许的输入类型，以及当前协议如何表达这些输入。
查看文件大小、格式、上下文和请求限制；不要假设其他平台的上传方式可直接复用。
用一个较小的样例单独验证所需能力，保留时间、模型 ID、协议和结果。
需要工具调用或流式输出时分别验证，确认客户端也能读取相应返回内容。

如果文本可用而图片失败，应重点比较模型能力、内容格式和端点说明。文本调用成功并不能证明原生文件处理、工具调用或所有多模态场景都已兼容。

按模型、分组和输入类型查看价格

在价格页选择实际 Gemini 模型，核对输入与输出、上下文档位及页面列出的其他计费条件。对多模态请求，要看该模型详情如何描述对应输入的计费，不自行用纯文本价格估算所有输入。

完成样例后，对照调用记录查看实际用量和所用分组，再扩大批量任务。指定 GPT 福利分组的 0.05x 起不适用于推定 Gemini 价格；该倍率以本站模型详情基础价格为基准，仍受 GPT 模型和档位限制。其他活动资格与叠加条件以站内当前配置为准。

用“基础文本是否成功”分流排查

基础文本也失败时，401 先检查令牌与当前协议的鉴权方式，403 检查模型和分组权限，404 检查最终端点和模型 ID，429 查看限流及并发说明。同时核对余额和错误正文，状态码不能单独说明全部原因。

只有加入图片、文件或工具后才出现 400，先去掉新增内容回到基础请求，再核对输入格式、功能限制和所选模型。不要用切换到另一种协议作为未经确认的修复方式。

反馈时附客户端、协议、模型 ID、分组、请求时间以及已脱敏的错误正文。可说明“纯文本成功，加入某类输入后失败”，帮助定位能力或格式差异；完整 API Key 不应进入公开问题记录。