---
title: "通过名称查询模型"
method: GET
path: "/v1/models/name/{name}"
tags: ["ModelSquareService"]
---

# 通过名称查询模型

`GET /v1/models/name/{name}`

GetModelByName 按 model_name 查询模型详情

## Path parameters

- `name` string, required

## Response `200`

OK

- ChannelV1GetModelByNameReply
  - `model` ChannelV1PublicModel — PublicModel C 端模型展示信息
    - `callCount` string — call_count 模型累计请求数，来源为小时聚合表。
    - `capabilities` string[]
    - `categoryId` string
    - `categoryName` string
    - `contextWindow` integer
    - `currency` string
    - `description` string
    - `descriptionZh` string
    - `endpointTypes` string[]
    - `faq` ChannelV1PublicModelFaq[] — faq / faq_zh 落地页常见问题（仅详情接口 GetModel/GetModelByName 返回，ListModels 不带，控制列表载荷）。 空数组时前端隐藏 FAQ 区域。
      - `answer` string
      - `question` string
    - `faqZh` ChannelV1PublicModelFaq[]
      - `answer` string
      - `question` string
    - `id` string
    - `inputPriceCny` string
    - `inputPriceOrig` string
    - `isAvailable` boolean
    - `isNew` boolean
    - `isRecommended` boolean
    - `maxOutputTokens` integer
    - `name` string
    - `outputPriceCny` string
    - `outputPriceOrig` string
    - `pricing` ChannelV1PublicModelPricing — PublicModelPricing C 端模型广场结构化定价（CRD 积分口径，与 admin ModelPricing 对齐）。 mode 决定计价方式，params 只携带该 mode 所需参数。价格为普通十进制字符串。
      - `image` ChannelV1PublicImagePricing — PublicImagePricing 图像按分辨率分档计费（每张图的 CRD 单价，十进制字符串）。
        - `imagePrice1k` string
        - `imagePrice2k` string
        - `imagePrice4k` string
        - `imagePrice512` string
      - `mode` string
      - `perRequest` ChannelV1PublicPerRequestPricing — PublicPerRequestPricing 按次计费（每次调用消耗的 CRD，十进制字符串）。
        - `perRequestPrice` string
      - `tieredExpr` ChannelV1PublicTieredExprPricing — PublicTieredExprPricing 表达式计费的安全公开投影。 statically_representable=false 时不下发原始表达式，前端统一提示动态计价。
        - `staticallyRepresentable` boolean
        - `tiers` ChannelV1PublicPricingTier[]
          - `conditions` ChannelV1PublicPricingCondition[]
            - `operator` string
            - `threshold` string
            - `variable` string
          - `name` string
          - `rates` ChannelV1PublicPricingRate[]
            - `dimension` string
            - `price` string
      - `token` ChannelV1PublicTokenPricing — PublicTokenPricing 按 token 计费（每 1M tokens 的 CRD 单价，十进制字符串）。
        - `audioInputPrice` string
        - `audioOutputPrice` string
        - `cacheCreation1hPrice` string
        - `cacheCreationPrice` string
        - `cachedInputPrice` string
        - `imageInputPrice` string
        - `imageOutputPrice` string
        - `inputPrice` string
        - `outputPrice` string
      - `video` ChannelV1PublicVideoPricing — PublicVideoPricing 视频按分辨率档每秒计费（分辨率档 → 每秒 CRD 单价，十进制字符串）。
        - `perSecondPrices` object
    - `ranking` integer
    - `releasedAt` string, date-time — released_at 模型发布时间（可空）；供前端按发布时间过滤/排序。
    - `sources` ChannelV1PublicModelSource[] — sources 卡片价格区展示的前两条资源变体（sale_ratio 升序，服务端排好序截断下发）； 完整列表走独立明细接口 GET /v1/models/{id}/sources。
      - `modelName` string
      - `pricing` ChannelV1PublicModelPricing — PublicModelPricing C 端模型广场结构化定价（CRD 积分口径，与 admin ModelPricing 对齐）。 mode 决定计价方式，params 只携带该 mode 所需参数。价格为普通十进制字符串。
        - `image` ChannelV1PublicImagePricing — PublicImagePricing 图像按分辨率分档计费（每张图的 CRD 单价，十进制字符串）。
          - `imagePrice1k` string
          - `imagePrice2k` string
          - `imagePrice4k` string
          - `imagePrice512` string
        - `mode` string
        - `perRequest` ChannelV1PublicPerRequestPricing — PublicPerRequestPricing 按次计费（每次调用消耗的 CRD，十进制字符串）。
          - `perRequestPrice` string
        - `tieredExpr` ChannelV1PublicTieredExprPricing — PublicTieredExprPricing 表达式计费的安全公开投影。 statically_representable=false 时不下发原始表达式，前端统一提示动态计价。
          - `staticallyRepresentable` boolean
          - `tiers` ChannelV1PublicPricingTier[]
            - `conditions` ChannelV1PublicPricingCondition[]
              - …
            - `name` string
            - `rates` ChannelV1PublicPricingRate[]
              - …
        - `token` ChannelV1PublicTokenPricing — PublicTokenPricing 按 token 计费（每 1M tokens 的 CRD 单价，十进制字符串）。
          - `audioInputPrice` string
          - `audioOutputPrice` string
          - `cacheCreation1hPrice` string
          - `cacheCreationPrice` string
          - `cachedInputPrice` string
          - `imageInputPrice` string
          - `imageOutputPrice` string
          - `inputPrice` string
          - `outputPrice` string
        - `video` ChannelV1PublicVideoPricing — PublicVideoPricing 视频按分辨率档每秒计费（分辨率档 → 每秒 CRD 单价，十进制字符串）。
          - `perSecondPrices` object
      - `saleRatio` string
      - `sourceCode` string
      - `sourceDescription` string
      - `sourceDescriptionEn` string
      - `sourceName` string
      - `sourceNameEn` string
    - `tags` string[]
    - `tagsZh` string[]
    - `vendorId` string
    - `vendorName` string
    - `vendorSlug` 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)