1. 确认模型已开放
打开模型目录,选择协议和具体配置。先查看“当前 Acosmi 价格”和开放状态,再进入详情的“代码接入”。如果显示价格待发布或尚未开放,请先等待该配置就绪;以下教程不会绕过这些条件。
模型 ID 是目录标识;示例请求中的 model 使用所选 profile UUID。不同协议的 UUID 可能不同,不能只复制模型名称替换它。目录参考解释各标识。
2. 准备 Key 与 API 余额
在密钥页准备个人 models:chat PAYG Key,并安全设置 ACOSMI_API_KEY 环境变量。按控制台提示准备 API Credits;会员订阅不自动支付此处调用。不要把 Key 写进网页源码。
3. 复制所选配置的请求
优先使用模型详情生成的代码。下面是已开放 V2、支持 max_tokens 的 OpenAI 格式模板,需要填写真实 UUID 和当前价格版本。Anthropic 配置请使用Messages 参考。
V2 模板显式设置单次金额上限 ¥1,即 max_credits="1000000"。V1 总 Token 示例只有输出数量上限,不能把它描述为同样的金额上限。
: "${ACOSMI_API_KEY:?Set your personal PAYG key}"
: "${ACOSMI_MODEL_ID:?Set a callable V2 OpenAI profile UUID}"
: "${ACOSMI_PRICE_VERSION:?Set its current positive effective_price_version}"
curl --fail-with-body 'https://acosmi.com/v1/chat/completions' \
-H "Authorization: Bearer $ACOSMI_API_KEY" \
-H 'Content-Type: application/json' \
--data-binary @- <<JSON
{"model":"$ACOSMI_MODEL_ID","messages":[{"role":"user","content":"Hello"}],"max_tokens":64,"stream":false,"acosmi_options":{"contract_version":"TEXT_COMPONENTS_V2","expected_price_version":${ACOSMI_PRICE_VERSION},"max_credits":"1000000"}}
JSON价格变化或预算不足时,先重新核对价格/报价并决定是否继续,不自动提高上限或重发 POST。
4. 识别响应
下面只展示协议结构,不是一次真实调用的回执:
{"choices":[{"message":{"role":"assistant","content":"Hello!"},"finish_reason":"stop"}],"usage":{"prompt_tokens":12,"completion_tokens":3,"total_tokens":15}}正文从 choices[].message 读取。响应状态不是 2xx 时先读取错误对象。stream=true 时使用流式事件,不要尝试一次解析为普通 JSON。
5. 核对请求与费用
保留 X-Request-ID 和响应提供的 X-Acosmi-Request-Id,到本人请求、用量和账单查原请求。输出已完成与费用已结算是两件事;超时、缺 usage 或待核对不能按 0 费用处理。