---
title: "PUT /v1/admin/models/{id}"
method: PUT
path: "/v1/admin/models/{id}"
tags: ["AdminModelService"]
---

# PUT /v1/admin/models/{id}

`PUT /v1/admin/models/{id}`

UpdateModel 更新模型

## Path parameters

- `id` string, required

## Request body

- AdminV1UpdateModelRequest
  - `capabilities` string[]
  - `contextWindow` integer
  - `description` string
  - `descriptionZh` string
  - `id` string
  - `isNew` boolean
  - `isRecommended` boolean
  - `maxOutputTokens` integer
  - `modelName` string
  - `pricing` AdminV1ModelPricing — ModelPricing 模型定价：mode 决定计价方式，params 只携带该 mode 所需参数。
    - `image` AdminV1ImagePricing — ImagePricing 图像按分辨率分档计费参数（每张图的 CRD 单价）。
      - `imagePrice1k` number, double
      - `imagePrice2k` number, double
      - `imagePrice4k` number, double
      - `imagePrice512` number, double
    - `mode` string
    - `perRequest` AdminV1PerRequestPricing — PerRequestPricing 按次计费参数：每次调用预设消耗的 CRD（"次"由端点定义）。
      - `perRequestPrice` number, double
    - `tieredExpr` AdminV1TieredExprPricing — TieredExprPricing 表达式计费参数：一行 DSL 表达式定义完整定价逻辑。 语义模型见 internal/pkg/billingexpr, 变量集 p/c/len/cr/cc/cc1h/img/img_o/ai/ao, 函数集 tier/max/min/abs/ceil/floor/hour/minute/day/weekday/month。 编译期校验 (语法 + tier() 字面量首参 + 节点数 <= 500), 冒烟运行拒绝负数 cost。
      - `expr` string
    - `token` AdminV1TokenPricing — TokenPricing 按 token 计费参数（每 1M tokens 的 CRD 单价）。
      - `audioInputPrice` number, double
      - `audioOutputPrice` number, double
      - `cacheCreation1hPrice` number, double — 迁移 0022 追加：Anthropic ephemeral 1h TTL 缓存创建独立单价（≠ 5m 部分的 cache_creation_price）。 缺省/=0 时 pricing 层回退用 cache_creation_price，保持向后兼容。
      - `cacheCreationPrice` number, double — 扩展（可选）：缓存创建 + 图片/音频输入·音频补全 token 单价（每 1M tokens 的 CRD 单价）。
      - `cachedInputPrice` number, double
      - `imageInputPrice` number, double
      - `imageOutputPrice` number, double — 迁移 0022 追加：多模态图片输出 token 单价（gpt-image completion_tokens_details.image_tokens 计费）。 缺省/=0 时 pricing 层回退用 output_price。
      - `inputPrice` number, double
      - `outputPrice` number, double
    - `video` AdminV1VideoPricing — VideoPricing 视频按分辨率档每秒计费参数：分辨率档 → 每秒 CRD 单价（如 {"720p":0.9,"1080p":1.6}）。
      - `perSecondPrices` object
  - `ranking` integer
  - `releasedAt` string, date-time
  - `status` integer
  - `tags` string[]
  - `tagsZh` string[]
  - `vendorId` string

## Response `200`

OK

- AdminV1UpdateModelReply
  - `model` AdminV1ModelInfo — ModelInfo 模型信息
    - `capabilities` string[]
    - `contextWindow` integer
    - `description` string
    - `descriptionZh` string
    - `faq` AdminV1ModelFaqItem[]
      - `answer` string
      - `question` string
    - `faqZh` AdminV1ModelFaqItem[]
      - `answer` string
      - `question` string
    - `id` string
    - `isNew` boolean
    - `isRecommended` boolean
    - `maxOutputTokens` integer
    - `modelName` string
    - `pricing` AdminV1ModelPricing — ModelPricing 模型定价：mode 决定计价方式，params 只携带该 mode 所需参数。
      - `image` AdminV1ImagePricing — ImagePricing 图像按分辨率分档计费参数（每张图的 CRD 单价）。
        - `imagePrice1k` number, double
        - `imagePrice2k` number, double
        - `imagePrice4k` number, double
        - `imagePrice512` number, double
      - `mode` string
      - `perRequest` AdminV1PerRequestPricing — PerRequestPricing 按次计费参数：每次调用预设消耗的 CRD（"次"由端点定义）。
        - `perRequestPrice` number, double
      - `tieredExpr` AdminV1TieredExprPricing — TieredExprPricing 表达式计费参数：一行 DSL 表达式定义完整定价逻辑。 语义模型见 internal/pkg/billingexpr, 变量集 p/c/len/cr/cc/cc1h/img/img_o/ai/ao, 函数集 tier/max/min/abs/ceil/floor/hour/minute/day/weekday/month。 编译期校验 (语法 + tier() 字面量首参 + 节点数 <= 500), 冒烟运行拒绝负数 cost。
        - `expr` string
      - `token` AdminV1TokenPricing — TokenPricing 按 token 计费参数（每 1M tokens 的 CRD 单价）。
        - `audioInputPrice` number, double
        - `audioOutputPrice` number, double
        - `cacheCreation1hPrice` number, double — 迁移 0022 追加：Anthropic ephemeral 1h TTL 缓存创建独立单价（≠ 5m 部分的 cache_creation_price）。 缺省/=0 时 pricing 层回退用 cache_creation_price，保持向后兼容。
        - `cacheCreationPrice` number, double — 扩展（可选）：缓存创建 + 图片/音频输入·音频补全 token 单价（每 1M tokens 的 CRD 单价）。
        - `cachedInputPrice` number, double
        - `imageInputPrice` number, double
        - `imageOutputPrice` number, double — 迁移 0022 追加：多模态图片输出 token 单价（gpt-image completion_tokens_details.image_tokens 计费）。 缺省/=0 时 pricing 层回退用 output_price。
        - `inputPrice` number, double
        - `outputPrice` number, double
      - `video` AdminV1VideoPricing — VideoPricing 视频按分辨率档每秒计费参数：分辨率档 → 每秒 CRD 单价（如 {"720p":0.9,"1080p":1.6}）。
        - `perSecondPrices` object
    - `ranking` integer
    - `releasedAt` string, date-time
    - `status` integer
    - `tags` string[]
    - `tagsZh` string[]
    - `updatedAt` string, date-time
    - `vendorId` string

---

[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)