文档

OpenAI Chat Completions 接口参考

POST /v1/chat/completions:请求字段、响应与流式说明。

端点与前置条件

POST https://acosmi.com/v1/chat/completions

使用个人 PAYG Key 的 Authorization: Bearer 认证,scope 为 models:chat。标准兼容层与所选 openai profile 都须已开放;价格、财务与发布状态以目录为准。兼容本请求格式不表示支持厂商所有 API。

请求字段

字段类型使用说明
modelstring所选配置的 profile UUID,不用页面展示名称替代
messagesarray至少一条消息;结构遵循此协议
max_tokensinteger显式设置正数,不超过该配置最大输出;本页示例用 64
streambooleanfalse 为 JSON,true 为 SSE
temperature / top_pnumber仅在配置声明时发送,具体范围随模型变化
tools / tool_choicearray / string or object只对支持工具调用的配置使用,结构随协议变化
acosmi_optionsobjectV2 价格版本和金额上限等 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"。

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
: "${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

acosmi_options 不发送给模型厂商。价格版本变化会要求重新确认,不能自动加大预算。旧 V1 总 Token 合同不使用这组 V2 字段;请从所选配置详情复制相应模板。

正常响应

以下是缩略结构示意,不是生产运行回执;usage 数字仅用于说明字段:

json
{"choices":[{"message":{"role":"assistant","content":"Hello!"},"finish_reason":"stop"}],"usage":{"prompt_tokens":12,"completion_tokens":3,"total_tokens":15}}
{"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