跳至主要内容

模型目录与调用配置

GET /api/open/v1/catalog/entries:查模型、协议、能力与当前开放状态。

请求

sh
curl --fail-with-body https://acosmi.com/api/open/v1/catalog/entries
curl --fail-with-body https://acosmi.com/api/open/v1/capabilities

这两个查询是匿名只读请求。单个模型可使用 GET /api/open/v1/catalog/entries/{publicKey}。/v1/models 属于标准协议接口,凭证要求与匿名目录不同,不能混用。

标识与响应字段

字段类型用途
version / observed_atstring目录版本与观察时间
data[].model_idstring模型目录标识,用于查找和展示
data[].public_keystring公开详情 URL 的模型键
data[].namestring当前展示名称及必要提醒
profiles[].idUUID具体执行配置;本平台示例使用的调用标识
profiles[].wirestringopenai 或 anthropic
context_window / max_output_tokensnumber该配置声明的上下文与输出上限
input_modalitiesarray已声明的输入模态,不是生成类型
capabilities / supported_parametersobject / array当前配置的能力和参数,不取其他配置的并集
pricing_v2object / nullV2 有效价格版本、分项费率、输入阶梯等
contract_versionsarray此配置声明的计费合同

响应结构示意

以下只是字段形状,省略了其他字段,不是可执行模型或价格证明:

json
{"version":"catalog-version","observed_at":"2026-11-14T00:00:00Z","data":[{"model_id":"MODEL_ID","public_key":"PUBLIC_KEY","name":"Model name","profiles":[{"id":"PROFILE_UUID","wire":"openai","protocol_supported":false,"price_status":"missing_price","pricing_v2":null}]}]}

判断是否可用

协议开放、价格确认、财务就绪与对应版本的发布验收需要同时满足。V1 使用自己的 price_ack_ready / financial_ready / release_accepted;V2 使用自己的价格状态、financial_ready_v2 / release_accepted_v2。还须具有受支持的输出预算参数和有效上限。

全局 compatV1Enabled=true 只说明标准兼容层开启,不表示所有配置都能调用。服务端会在执行时再次判断凭证和当前条件。未知、未就绪或价格缺失不等于免费。

使用建议

筛选多个条件时必须由同一个 profile 满足。保存该 profile 的 UUID、wire 和 model 关联,在详情、示例和试用中使用同一组合。不要把目录中的供应渠道参考信息当成上游直连凭证。

返回模型列表 · 第一次请求