跳到主要内容

List Available Models

GET 
https://api.knox.chat/v1/models

返回通过 API 可用的公开模型列表。认证是可选的：不携带 API Key 的请求会返回公开的活跃模型列表；携带 Bearer Token 的请求会返回该 token 可访问的模型列表。

公开的未认证请求限制为每分钟 60 次，并且可能被缓存最多 5 分钟。

请求​

此端点不需要任何请求参数。

请求头​

NameTypeRequiredDescription
AuthorizationStringNo可选的 Bearer 认证，格式为 Bearer <token>。提供后，响应会过滤为该 token 可访问的模型。

cURL 示例​

不携带 API Key 的公开请求：

curl -X GET https://api.knox.chat/v1/models

携带认证信息以获取 token 对应的可用模型：

curl -X GET https://api.knox.chat/v1/models \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json"

响应​

成功响应 (200)​

{
  "object": "list",
  "data": [
    {
      "id": "anthropic/claude-sonnet-4.6",
      "object": "model",
      "created": 1626777600,
      "owned_by": "openai",
      "permission": [
        {
          "id": "modelperm-LwHkVFn8AcMItP432fKKDIKJ",
          "object": "model_permission",
          "created": 1626777600,
          "allow_create_engine": true,
          "allow_sampling": true,
          "allow_logprobs": true,
          "allow_search_indices": false,
          "allow_view": true,
          "allow_fine_tuning": false,
          "organization": "*",
          "group": null,
          "is_blocking": false
        }
      ],
      "root": "anthropic/claude-sonnet-4.6",
      "parent": null,
      "context_length": 200000,
      "architecture": {
        "modality": "text+image->text",
        "input_modalities": [
            "image",
            "text"
        ],
        "output_modalities": [
            "text"
        ],
        "tokenizer": "Claude"
      },
      "pricing": {
        "prompt": "0.000003",
        "completion": "0.000015",
        "request": "0",
        "image": "0.0048",
        "audio": "0",
        "web_search": "0",
        "internal_reasoning": "0",
        "input_cache_read": "0.0000003",
        "input_cache_write": "0.00000375"
      },
      "top_provider": {
        "context_length": 200000,
        "max_completion_tokens": 64000
      },
      "supported_parameters": [
        "max_tokens",
        "temperature",
        "stop",
        "reasoning",
        "include_reasoning",
        "tools",
        "tool_choice",
        "top_p",
        "top_k"
      ]
    },
    more...
  ]
}

响应结构​

NameTypeDescription
objectstring对象类型，固定为 "list"
dataarray可用模型的数组
data[].idstring模型的唯一标识符
data[].objectstring对象类型，固定为 "model"
data[].createdinteger模型创建时的 Unix 时间戳
data[].owned_bystring模型的所有者
data[].permissionarray模型权限数组
data[].permission[].idstring权限 ID
data[].permission[].objectstring对象类型
data[].permission[].createdinteger权限创建时的时间戳
data[].permission[].allow_create_engineboolean是否允许创建引擎
data[].permission[].allow_samplingboolean是否允许采样
data[].permission[].allow_logprobsboolean是否允许获取对数概率
data[].permission[].allow_search_indicesboolean是否允许搜索索引
data[].permission[].allow_viewboolean是否允许查看
data[].permission[].allow_fine_tuningboolean是否允许微调
data[].permission[].organizationstring组织信息
data[].permission[].groupnull or string分组信息
data[].permission[].is_blockingboolean权限是否为阻塞性的
data[].rootstring根模型 ID
data[].parentnull or string父模型 ID
data[].context_lengthinteger模型的最大上下文长度
data[].architectureobject模型架构信息
data[].architecture.modalitystring从输入到输出的模态映射（例如 "text+image->text"）
data[].architecture.input_modalitiesarray of strings支持的输入模态（例如 "text"、"image"）
data[].architecture.output_modalitiesarray of strings支持的输出模态（例如 "text"）
data[].architecture.tokenizerstring使用的分词器类型
data[].pricingobject模型使用的定价信息
data[].pricing.promptstring每个 prompt token 的价格
data[].pricing.completionstring每个 completion token 的价格
data[].pricing.requeststring每次请求的基本费用
data[].pricing.imagestring每张图片处理的费用
data[].pricing.audiostring音频处理费用
data[].pricing.web_searchstring网络搜索费用
data[].pricing.internal_reasoningstring内部推理费用
data[].pricing.input_cache_readstring输入缓存读取费用
data[].pricing.input_cache_writestring输入缓存写入费用
data[].top_providerobject顶级提供商信息
data[].top_provider.context_lengthinteger顶级提供商提供的上下文长度
data[].top_provider.max_completion_tokensinteger最大 completion token 数量
data[].supported_parametersarray of strings支持的参数列表