请求
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_at | string | 目录版本与观察时间 |
data[].model_id | string | 模型目录标识,用于查找和展示 |
data[].public_key | string | 公开详情 URL 的模型键 |
data[].name | string | 当前展示名称及必要提醒 |
profiles[].id | UUID | 具体执行配置;本平台示例使用的调用标识 |
profiles[].wire | string | openai 或 anthropic |
context_window / max_output_tokens | number | 该配置声明的上下文与输出上限 |
input_modalities | array | 已声明的输入模态,不是生成类型 |
capabilities / supported_parameters | object / array | 当前配置的能力和参数,不取其他配置的并集 |
pricing_v2 | object / null | V2 有效价格版本、分项费率、输入阶梯等 |
contract_versions | array | 此配置声明的计费合同 |
响应结构示意
以下只是字段形状,省略了其他字段,不是可执行模型或价格证明:
{"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 关联,在详情、示例和试用中使用同一组合。不要把目录中的供应渠道参考信息当成上游直连凭证。