第一次 API 调用

从登录、到账与 Key 到已开放模型的最小调用，分别核对交付和费用。

模型门户与原请求核账（1.1候选）

从模型API 选择业务模型及具体profile UUID；新目录 GET /api/open/v1/catalog/entries 与控制台共用。试用入口 /zhuanqian/console/playground 使用本人登录态与内存PAYG Key，输出预算默认min(1024,所选profile上限)，按wire声明选择max_tokens/max_completion_tokens，禁止自动POST重发。流DONE不证明结算；原消费/追踪ID在本人请求页核账，金额未知显示—。

V2先获取完整本次参数报价，用户确认费用cap后另一次点击执行；参数/价格改变须重新报价。Key轮换继承原月预算和未结hold。付款只有可信FULFILLED后允许手动返回原组合，不恢复Key/prompt或自动运行。完整新接口及预算/测量定义见模型平台合同。

个人按量付费（池③）

打开开放控制台，完成统一登录和联系方式绑定。在 Credits 充值页选择套餐并按订单展示的二维码或付款链接支付。只有订单“已到账”才表示履约完成；“已付款，等待履约”不能当作可用余额。随后创建个人 models:chat Key，明文只显示一次。

先匿名查询 GET /api/open/v1/catalog/models 和 GET /api/open/v1/capabilities。按目录中已支持的格式选择模型 UUID 或业务 ID；同业务 ID 可以有多个物理 profile。scope ready 不替代模型/profile 的价约就绪。此候选尚未获得生产旅程验收，不声明所有模型、媒体或敏感执行可用。

export ACOSMI_BASE_URL=https://acosmi.com
# Set ACOSMI_API_KEY securely and ACOSMI_MODEL_ID from the current catalog.
: "${ACOSMI_API_KEY:?Set your personal PAYG API Key}"
: "${ACOSMI_MODEL_ID:?Choose a supported catalog model/profile}"
curl --fail-with-body "$ACOSMI_BASE_URL/api/open/v1/models/$ACOSMI_MODEL_ID/chat" \
  -H "Authorization: Bearer $ACOSMI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Hello"}],"stream":false,"max_tokens":64}'
export ACOSMI_BASE_URL=https://acosmi.com
# Set ACOSMI_API_KEY securely and ACOSMI_MODEL_ID from the current catalog.
: "${ACOSMI_API_KEY:?Set your personal PAYG API Key}"
: "${ACOSMI_MODEL_ID:?Choose a supported catalog model/profile}"
curl --fail-with-body "$ACOSMI_BASE_URL/api/open/v1/models/$ACOSMI_MODEL_ID/chat" \
  -H "Authorization: Bearer $ACOSMI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Hello"}],"stream":false,"max_tokens":64}'

记录响应中的请求标识，在控制台用量和账单按消费请求 ID 核对实际结算、预占、待核对及冲正。待核对不代表免费；页面汇总和完整 CSV 使用同一时间边界和筛选。调用 POST 不盲目自动重试，传输超时不能证明没有执行。测试完吊销 Key。

会员 OAuth SDK 的只读示例

这是另一个凭证旅程：Client.create/login 使用会员 OAuth，不充值或消费池③。以下完整定义 client，使用实际 action 字段；敏感动作必须同时满足服务端准入、scope、step-up 与资金合同。

import { Client, ScopeComplianceEvidenceRead } from "@acosmi/sdk-ts";

const client = await Client.create({ serverURL: "https://acosmi.com" });
await client.login("Read-only integration", [ScopeComplianceEvidenceRead]);
const capabilities = await client.compliance.getCapabilities();
console.log(capabilities.map(({ action, executable, state }) => ({ action, executable, state })));
import { Client, ScopeComplianceEvidenceRead } from "@acosmi/sdk-ts";

const client = await Client.create({ serverURL: "https://acosmi.com" });
await client.login("Read-only integration", [ScopeComplianceEvidenceRead]);
const capabilities = await client.compliance.getCapabilities();
console.log(capabilities.map(({ action, executable, state }) => ({ action, executable, state })));

示例锁定 @acosmi/sdk-ts@2.19.6。/v1 标准兼容端点只有在 compatV1Enabled 和对应 profile 门禁完成后才可使用；x-api-key 是独立认证头开关。充值、Key 和模型成功调用仍需对应候选的真实业务回执。