---
title: "获取单个模型厂商"
method: GET
path: "/models/providers/{provider}"
tags: ["模型管理"]
---

# 获取单个模型厂商

`GET /models/providers/{provider}`

## Request

- Base URL: `/api/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/models/providers/{provider}`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `X-API-Key`

返回一个厂商的定义及其模型目录，可按模型类型与关键词过滤模型

## Path parameters

- `provider` string, required

## Query parameters

- `model_type` 'chat' | 'embedding' | 'rerank' | 'vllm' | 'asr'
- `keyword` string

## Response `200`

厂商详情

- object
  - `data` InternalHandlerModelProviderDTO
    - `api` 'openai-completions' | 'openai-responses' | 'anthropic-messages' | 'google-generative-ai' | 'ollama'
    - `auth` 'bearer' | 'api-key' | 'x-api-key' | 'x-goog-api-key' | 'none' | 'signed'
    - `credentialLabels` GithubComTencentWeKnoraInternalModelsProvidersCredentialLabel[]: CredentialLabels rename the primary credential input for the model types that do not take a plain API key (signed rerank APIs).
      - `hint` string: Hint is rendered under the input, for a warning the label cannot carry.
      - `hints` object
      - `label` string
      - `labels` object
      - `model_types` GithubComTencentWeKnoraInternalTypesModelType[]: ModelTypes restricts the override; empty means every type.
      - `placeholder` string
      - `placeholders` object
      - `required` boolean: Required marks the credential mandatory even where the generic label calls it optional.
    - `defaultUrls` object
    - `description` string
    - `descriptions` object
    - `extraFields` GithubComTencentWeKnoraInternalModelsProvidersExtraField[]
      - `default` string
      - `key` string
      - `label` string
      - `labels` object
      - `model_types` GithubComTencentWeKnoraInternalTypesModelType[]: ModelTypes restricts the field to some model types; empty means all.
      - `options` GithubComTencentWeKnoraInternalModelsProvidersExtraFieldOption[]
        - `label` string
        - `labels` object
        - `value` string
      - `placeholder` string
      - `placeholders` object: Placeholders carries localized variants of Placeholder.
      - `required` boolean
      - `secret` boolean: Secret marks values that must never be echoed back to the UI.
      - `type` string: "string", "number", "boolean", "select", "password"
    - `icon` string: Icon is a data: URI (image/svg+xml;base64) ready for <img src>.
    - `label` string
    - `labels` object
    - `modelTypes` string[]
    - `models` InternalHandlerModelCatalogEntryDTO[]
      - `api` 'openai-completions' | 'openai-responses' | 'anthropic-messages' | 'google-generative-ai' | 'ollama'
      - `context_window` integer
      - `cost` GithubComTencentWeKnoraInternalModelsModelCost
        - `cache_read` number
        - `cache_write` number
        - `currency` string
        - `input` number
        - `output` number
      - `dimension` integer
      - `id` string
      - `input` string[]
      - `max_output_tokens` integer
      - `name` string
      - `reasoning` boolean
      - `source` string: Source is the vendor page these facts were read from, so the editor can send an operator to the documentation for this exact model.
      - `thinking_levels` GithubComTencentWeKnoraInternalModelsApiReasoningEffort[]
      - `type` string
    - `order` integer
    - `requiresAuth` boolean
    - `thinking` InternalHandlerProviderThinkingDTO
      - `format` string
      - `levels` GithubComTencentWeKnoraInternalModelsApiReasoningEffort[]
    - `value` string
    - `website` string
  - `success` boolean

## Other responses

- `400`: 请求参数错误
- `404`: 厂商不存在

## Changes

- **2026-10-16** `3277b0857c99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tencentblueking/apis/weknora-api/changes/models/providers/:provider/get.md)

---

[API](https://skmtc.dev/tencentblueking/apis/weknora-api.md) - [All operations](https://skmtc.dev/tencentblueking/apis/weknora-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tencentblueking/apis/weknora-api/revisions/685d1f9fce30?raw)