Gemini 系列

适用模型

实际可用模型以模型列表为准。

特殊处理

平台为 gemini 系列模型接入的部分线路不支持标准的 Images 接口协议,平台内部会转换为其原生的内容生成协议再转换回来。请求命中这类线路时存在以下差异:

• prompt 为必填字段,缺失时返回 400 invalid_request(prompt required)。
• n 只支持 1,传大于 1 的值返回 400 invalid_request(n>1 not supported for gemini image models)。
• size 不会转发给上游,但仍按你传入的 size 值计费。
• 响应被合成为 OpenAI 格式,图片一定在 data[].b64_json 中(不会返回 url)。
• 若上游本次没有返回图片(例如内容被拒绝、只返回了文本),平台按上游失败处理,返回 502 upstream_error 且本次调用不扣费(预扣费用已退款)。

请求是否命中这类线路由平台的渠道调度决定,不与模型名固定绑定。因此调用 gemini 系列模型时,建议始终按上述最严格的约束传参(始终传 prompt、n 不超过 1),并在解析响应时同时兼容 url 与 b64_json 两种形状。

请求协议

OpenAI 风格:n/size 放在请求体顶层,通用字段与校验规则见接口说明。

响应格式

命中协议转换线路时为合成的 OpenAI 格式,图片以 base64 内联返回:

{"created": 1720000000, "data": [{"b64_json": "..."}]}

响应形状以实际返回为准,建议同时兼容 url 与 b64_json 两种形状。

计费与错误

与接口说明一致:按张计费,价格见模型列表,错误码见错误码。注意上游未返回图片时按失败处理且不扣费(见上文"特殊处理")。