跳至主要内容

第一次模型 API 请求

选择当前可用的配置,发送请求并核对结果。

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 示例只有输出数量上限,不能把它描述为同样的金额上限。

sh
: "${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. 识别响应

下面只展示协议结构,不是一次真实调用的回执:

json
{"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 费用处理。

工具与结构化输出 · 计费说明 · 会员 OAuth 独立教程