---
title: "GET /v1/admin/settings/model"
method: GET
path: "/v1/admin/settings/model"
tags: ["AdminModelSettingsService"]
---

# GET /v1/admin/settings/model

`GET /v1/admin/settings/model`

GetModelSettings 读取模型全局设置。

## Response `200`

OK

- AdminV1GetModelSettingsReply
  - `settings` AdminV1ModelSettings — ModelSettings 模型相关全局设置。字段分两类： **JSON blob 字段**（map/slice 类，动态 key/element 数量）： - gemini_version_map_json：`map<string,string>`，key = model 名或 "default"， value ∈ {"v1","v1beta","v1alpha"}。缺省 `{"default":"v1beta","gemini-1.0-pro":"v1"}`。 - claude_default_max_tokens_json：`map<string,int>`，key = model 名或 "default"， value = 1..1_000_000。缺省 `{"default":8192}`；网关保证 "default" 键始终存在。 - gemini_supported_imagine_models_json：`[]string`，命中即注入 responseModalities。 **强类型标量字段**（Wave 2，bool/double）： - 全部用 `optional`，让"未设置"（PATCH 语义）与"显式 false / 0"可区分—— bool 默认 false 但 thoughtSignature 业务默认 true，没有 optional 就没办法 只更新其它字段而不误改 thoughtSignature。 用 JSON blob 传字符串而非结构化 map，是因为 proto2/3 map 字段类型选择僵硬 （不能是 map<string, any>），JSON 更好扩展新 key； 服务器侧解析 + 校验，前端只需拼合法 JSON。
    - `claudeDefaultMaxTokensJson` string — Claude 缺省 max_tokens JSON。空串 / "{}" / "null" → 回退 {"default":8192}。
    - `claudePreserveThinkingSuffixModelsJson` string — 保留 -thinking 后缀的模型清单 JSON []string；空 / "[]" / "null" = 空名单（所有模型都剥后缀）。
    - `claudeThinkingAdapterEnabled` boolean — 是否识别 Claude `-thinking` 后缀 + opus-4 系 `-<effort>` 后缀（默认 true）。
    - `claudeThinkingBudgetTokensPercentage` number, double — `-thinking` 路径 budget = max_tokens × 该百分比。合法区间 (0.1, 1.0)，默认 0.8。
    - `geminiRemoveFunctionResponseIdEnabled` boolean — 是否清空 parts[].functionResponse.id（Vertex AI 兼容）。默认 true。
    - `geminiSupportedImagineModelsJson` string — 支持图像生成的 Gemini 模型清单 JSON []string。命中即注入 responseModalities: ["TEXT","IMAGE"]。 空串 / "[]" / "null" → 回退 5 个出厂默认模型名。
    - `geminiThinkingAdapterEnabled` boolean — 是否启用 -thinking / -thinking-N / -nothinking 后缀适配。默认 false（管理员显式打开）。
    - `geminiThinkingBudgetPercentage` number, double — `-thinking` 无固定预算时 budget = maxOutputTokens × 该百分比。合法区间 (0, 1.0]，默认 0.6。
    - `geminiThoughtSignatureEnabled` boolean — 是否给 assistant/model role 消息注入哨兵字符串（避免 Gemini 2.5+ 多轮 function-call 报 400）。 optional：未传 = 保持当前值；true/false = 覆盖。默认 true。
    - `geminiVersionMapJson` string — Gemini API 版本映射 JSON。空串 / "{}" / "null" → 回退出厂默认。
    - `grokViolationDeductionAmount` number, double — 每次违规的美元金额（默认 0.05）。合法区间 (0, 10]。
    - `grokViolationDeductionEnabled` boolean — 是否对 CSAM 违规响应额外扣违规金（默认 true）。

---

[API](https://skmtc.dev/apiqik/apis/apiqik-api.md) · [All operations](https://skmtc.dev/apiqik/apis/apiqik-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apiqik/apiqik-api/revisions/e06b96127408/schema)