API

模型列表

列出工作区可见的模型供给

GET /v1/models 返回当前工作区可见的模型目录。目录会随供应商供给、健康状态和策略变化。

列出模型

使用与推理请求相同的工作区 API Key 认证。

curl https://api.octoryn.dev/v1/models   -H "Authorization: Bearer $OCTORYN_API_KEY"

响应形态

响应为 object=list Envelope。data 包含模型项，_meta 描述当前目录快照。

{
  "object": "list",
  "data": [{
    "id": "gpt-4o",
    "object": "model",
    "owned_by": "octoryn",
    "provider": "openai",
    "provider_label": "Powered by OpenAI",
    "is_byok_compatible": true,
    "context_window": 128000,
    "pricing_tier": "frontier"
  }],
  "_meta": {"total": 1, "sources": {}, "cached_until_ms": 0, "expanded": []}
}

模型字段

客户端只应依赖真正需要的字段，并容忍新增字段。

id — 兼容推理请求可使用的模型标识
provider 与 provider_label — 当前供给归属
is_byok_compatible — 是否可通过客户自有凭据提供
context_window — 已知时报告的上下文容量
pricing_tier — 发布时的相对运营类别
available_providers — 仅在请求供应商展开且可用时出现

展开供应商

运营方需要查看每个模型的合资格供应商集合时，可使用 ?expand=providers。展开结果可能包含 provider_id、model_id、status、latency_ms 与 kind。

GET /v1/models?expand=providers

下一篇模型与策略路由 →