Skip to content

GET /v1/models

列出当前账号可调用的全部模型。返回结构在 OpenAI 协议基础上扩展了 capabilities / context_window 等字段。

列出当前账号可调用的全部模型。返回结构在 OpenAI 协议基础上扩展了 capabilities / context_window 等字段。

GEThttps://www.kukuai.fyi/api-proxy/china/v1/models

请求需携带 `Authorization: Bearer ``<API_KEY>```, 其中 Key 由你在 https://kukuai.fyi 控制台「API Keys」页面创建。返回的列表是「该 API Key 当前可调用的模型」, 权限受控制台分配影响。

调用示例

curl https://www.kukuai.fyi/api-proxy/china/v1/models \
  -H "Authorization: Bearer $KUKUAI_API_KEY"

响应示例

200 OKjson

{
  "object": "list",
  "data": [
    {
      "id": "deepseek-v4-pro",
      "object": "model",
      "created": 1729000000,
      "owned_by": "deepseek",
      "capabilities": ["chat", "function_calling", "json_mode", "streaming"],
      "context_window": 131072,
      "modalities": ["text"]
    },
    {
      "id": "claude-sonnet-4-6",
      "object": "model",
      "created": 1727000000,
      "owned_by": "anthropic",
      "capabilities": ["chat", "vision", "function_calling", "streaming"],
      "context_window": 200000,
      "modalities": ["text", "image"]
    },
    {
      "id": "qwen3-coder",
      "object": "model",
      "created": 1726000000,
      "owned_by": "alibaba",
      "capabilities": ["chat", "streaming"],
      "context_window": 65536,
      "modalities": ["text"]
    }
  ]
}

响应字段

字段类型必填说明
objectstring必填固定为 "list"
dataarray<Model>必填当前账号可见的模型列表,元素结构见下表。

每个 Model 对象的字段:

字段类型必填说明
idstring必填模型 ID,传给 chat/completionsmodel 字段。
objectstring必填固定为 "model"
createdinteger可选模型上架时间戳,Unix 秒。
owned_bystring可选归属 provider,例如 deepseek / anthropic
capabilitiesstring[]可选kukuai.fyi 扩展。可能值包括 chat / function_calling / vision / json_mode / streaming
context_windowinteger可选模型上下文 token 上限。具体值由后端配置下发,可能随模型升级变化。
modalitiesstring[]可选支持的模态:text / image / audio / video

使用建议

  • 挑选模型:通过 capabilities 过滤——例如需要 function calling 的场景只保留 function_calling in capabilities 的模型。
  • 上下文长度:长文档处理任务用 context_window 排序, 挑选最合适的,避免超长输入导致 context_length_exceeded
  • 多模态:识别 modalities 是否包含image / audio,再决定能否传入对应内容。
  • 异常处理:参考 错误码,对model_not_found / permission_denied 给出友好提示。

统一 API 网关 · OpenAI Compatible