HTTP API 概述

按正式路由与凭证合同接入，OpenAPI是候选参照。

Anonymous catalog: GET /api/open/v1/catalog/models
Anonymous readiness: GET /api/open/v1/capabilities
PAYG model calls: /api/open/v1/models/{id}/chat or /anthropic for supported profiles
Standard compatibility: /v1/models, /v1/chat/completions, /v1/messages only after the shared gate passes
Console own-account funds: /api/distribution/api-credit/balance, /bills/page, /usage/page, /bills/export, /usage/export
Own order: /api/consumer/orders/{orderId}; checkout callbacks do not prove fulfillment

SDK OAuth的member/business路径和开放池③路径不同，不能只替换token来换资金池。Agent Run、签署、存证、媒体等扩展按自己的来源、scope、价约与交付合同启用。旧Bench、Session、Workspace原型路由不在正式开放导航中。

池③文本的有效 max_tokens 为正整数，硬上界 1,048,576；模型配置更低上限时优先使用该上限。省略或传零时依次使用模型默认输出预算、模型最大输出，缺省回落到 1,024；预占估算与 provider 使用同一个冻结输出上限。不支持 max_completion_tokens，请使用 max_tokens；池③仅支持一份输出 n=1。thinking.budget_tokens 若存在，必须是有限非负整数且不超过有效 max_tokens，字符串数字拒绝。完整预占估算必须是精确整数且不超过 9,007,199,254,740,991（2^53−1）。会员权益预算保留原合同。

本候选 Go 文本路由的 JSON 请求体上限为 32 MiB；实际可用上限取 Go、nginx/代理和所选上游限制的最小值，部署配置可能更低。源码合同不代表这些变更已在生产启用。

目录 profiles 保留物理 UUID，逐 profile 返回 wire_format、compat_profile、有效 capabilities 和 chat_runtime_supported。应按所需格式及操作选择具体 profile。顶层 capabilities 仅描述 capabilities_profile_id 指向的首个 profile，不能当作全部格式拥有相同能力。pricing_status 分别提供 TEXT_OUTPUT、IMAGE、SECOND；仅 ready 且有明确有效单价才可准入。缺失或未知状态不可当作 ready，零价也须显式免费合同。能力 readiness 不代替真实供应商验收。

候选 IMAGE 每次生成一张图片，必须提供规范 UUID Idempotency-Key；相同请求恢复沿用原键，换参数冲突。503 的 taskId 表示执行或结算尚未确认，暂不披露 URL/base64。使用原本人和原 API key 查询 GET /api/open/v1/models/{id}/images/tasks/{taskId}；原模型撤价/禁用不阻断已有任务恢复。未知 provider 执行不能换键重调。

UNKNOWN_IMAGE_V1 冻结 24 小时的平台责任期限，Java按原预占时间校验。期限内无法恢复结果时，image_unknown_resolved 释放客户预占并保留 UNKNOWN 证据；没有产物仍返回 503，不伪造零用量、不重调 provider。真实产物迟到后，须先确认真实 IMAGE 数量1事件，客户扣费为零、原合同成本由平台承担，再返回产物，原 UNKNOWN 保留。确定拒绝且真实释放确认后返回 400 failed。Java imageUnknownReady 是图片财务能力的必要条件，不代表供应商可用。这些是候选合同，生产启用与真实供应商验收分别记录。