# 模型与目录 (/docs/cloud/services/model/concepts/models-and-catalog)



模型目录描述可以选择什么；一次调用的记录描述实际用了多少、付了多少。两者用途不同。

## 模型 ID 与能力 [#模型-id-与能力]

请求中的 `model` 使用目录返回的完整 `id`，例如 `deepseek-flash`。显示名称不是 ID；相同 ID 也不表示底层版本永远不变，滚动版本应以模型说明为准。

`type` 区分语言、图像、语音、视频、向量等模型类别，不能据此推断它支持所有相关接口。`supported_apis` 才是已开放协议的列表；选择 Chat、Responses 或 Messages 前分别核对它。输入和输出模态说明能处理什么内容，不等于所有文件格式都能原生读取。

上下文窗口限制一次输入与生成可容纳的内容，不是每次必然能输出的长度。原生目录的字段为 `context_window`；OpenAI 兼容目录使用 `context_length`。输出上限需另看模型说明与 API 参考。

## 标价与实付 [#标价与实付]

目录 `pricing` 的金额为美元，单位由价格项决定。token 单价以每个 token 表达，展示为每百万 token 时乘以一百万；输入与输出分别定价。`input_cache_read` 是缓存命中时的输入读价，不保证每次都会命中。

并非所有模型按 token 计费：视频可按秒、图像可按张、OCR 可按页、转写可按音频分钟。价格项缺失不表示免费，不要把所有数值都乘以一百万。具体价格项与字段定义见[列出模型 API](/docs/api/native/model/listModels)。

Chat 响应的 `usage.cost` 是本次实付美元金额；用目录单价乘以 token 数只是估算，可能忽略缓存或其他计量。需要核对实际调用时，使用[快速开始中的生成记录查询](/docs/cloud/services/model/quickstart)。

## 可用率 [#可用率]

可用率衡量平台与上游能否完成有效请求：平台或上游原因的失败计入，调用方参数等原因造成的拒绝不计入。它不表示任意参数都能成功，也不保证下一次请求必然成功。

[模型目录](/docs/cloud/services/model/catalog)说明如何获取当前目录；本页不维护静态模型与价格清单。

[API 参考 →](/docs/api/native/model) · [Cookbook →](/docs/cookbook)