端点与前置条件
POST https://acosmi.com/v1/chat/completions
使用个人 PAYG Key 的 Authorization: Bearer 认证,scope 为 models:chat。标准兼容层与所选 openai profile 都须已开放;价格、财务与发布状态以目录为准。兼容本请求格式不表示支持厂商所有 API。
请求字段
| 字段 | 类型 | 使用说明 |
|---|---|---|
model | string | 所选配置的 profile UUID,不用页面展示名称替代 |
messages | array | 至少一条消息;结构遵循此协议 |
max_tokens | integer | 显式设置正数,不超过该配置最大输出;本页示例用 64 |
stream | boolean | false 为 JSON,true 为 SSE |
temperature / top_p | number | 仅在配置声明时发送,具体范围随模型变化 |
tools / tool_choice | array / string or object | 只对支持工具调用的配置使用,结构随协议变化 |
acosmi_options | object | V2 价格版本和金额上限等 Acosmi 扩展;详见下文 |
messages 中使用 system / user / assistant 等协议角色。正文从 choices[].message.content 读取;工具调用见 choices[].message.tool_calls。
以模型详情中的 supported_parameters 为准,不自动补未声明字段。输出参数存在入口差异:当前公开文本配置声明 max_tokens;不要未经接口确认改成 max_completion_tokens 或同时发送两者。
V2 请求模板
模板仅适用于已开放的 TEXT_COMPONENTS_V2 配置。价格版本必须是其当前正整数版本;¥1 上限传展示 Credits 字符串 "1000000"。
: "${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"}}
JSONacosmi_options 不发送给模型厂商。价格版本变化会要求重新确认,不能自动加大预算。旧 V1 总 Token 合同不使用这组 V2 字段;请从所选配置详情复制相应模板。
正常响应
以下是缩略结构示意,不是生产运行回执;usage 数字仅用于说明字段:
{"choices":[{"message":{"role":"assistant","content":"Hello!"},"finish_reason":"stop"}],"usage":{"prompt_tokens":12,"completion_tokens":3,"total_tokens":15}}可用输出、结束原因和费用状态分别处理。工具调用不是已执行工具;应用应检查工具名与参数、执行授权的操作,再按协议回传结果。工具指南提供两种格式的差异。
流式与错误
设置 stream=true 后以 text/event-stream 读取。OpenAI 流使用 choices[].delta,正常终止为 [DONE]。 保活、错误、断连不等于正常完成;详见流式指南。
非 2xx 响应先读协议错误对象;流已开始后的错误可能位于事件中,不能只检查 HTTP 200。记录请求标识,按错误处理查询或修正后再决定是否重发。
相关资料
模型目录 · 认证与密钥 · 计费 · 完整 OpenAPI