语言模型接口

语言模型按所选完整型号和分组调用。最小接入使用 Chat Completions；需要 Responses 时，先确认目标型号支持。两种协议的请求与输出结构不同，不能共用同一个 JSON 解析模板。

调用前检查

GET /v1/models 确认 Key 可用的完整模型 ID。模型名由本站目录定义，不自行删改后缀。图片和视频型号即使在目录中出现，也不能据此当作普通对话模型使用。

本页最小示例使用当前目录中的 gpt-5.5；Key 必须有对应语言模型分组权限。高级能力、上下文上限、推理参数、工具调用和多模态支持按具体型号，不在所有模型间统一承诺。

Chat Completions

POST /v1/chat/completions

bash

curl --fail-with-body --max-time 180 \
  https://openpix.cc/v1/chat/completions \
  -H "Authorization: Bearer $MXB_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model":"gpt-5.5",
    "messages":[{"role":"user","content":"用三句话介绍产品摄影的布光方法。"}],
    "stream":false
  }'

字段	类型	说明
model	string，必填	当前 Key 可用的完整语言模型 ID
messages	array，必填	有序消息数组，至少含本次请求内容
messages[].role	string	最小示例 user；system、assistant、tool 等角色按具体模型和协议
messages[].content	string 或协议允许的内容数组	纯文本先使用字符串；图片/音频等内容块需要单独确认支持
stream	boolean	false 为完整 JSON；true 为 SSE
temperature / top_p	number，可选	型号相关，初次接入省略，避免模型不支持而报错
max_tokens / max_completion_tokens	integer，可选	适用字段按型号，不能同时盲目传入两个版本
tools / tool_choice	object/array 等，可选	目标模型明确支持后按协议使用，不视为平台统一能力

非流式响应结构示意：

json

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "model": "gpt-5.5",
  "choices": [
    {
      "index": 0,
      "message": {"role": "assistant", "content": "示例回答"},
      "finish_reason": "stop"
    }
  ],
  "usage": {"prompt_tokens": 20, "completion_tokens": 40, "total_tokens": 60}
}

ID、内容和用量均为示意。不要默认 choices 永远非空；先处理 error。存在工具调用时，message.content 可能为空，应该按 tool_calls 分支处理，而不是自动重试。

finish_reason=length 通常表示输出达到限制；stop 表示本次正常停止；工具或其他终止原因按实际响应处理。输出截断不意味着原请求没计费。

多轮对话

Chat Completions 的普通请求由调用方传入需要的历史消息。仅重复提交相同用户标识，不会自动带上本地聊天记录。保存必要的 user / assistant 消息，并控制上下文长度。

传入的历史内容也会占用输入用量。长对话应按业务需求裁剪或总结；不能无限追加然后假定输入费用固定。不要向模型发送与当前业务无关的凭据或私有日志。

Responses

POST /v1/responses

bash

curl --fail-with-body --max-time 180 \
  https://openpix.cc/v1/responses \
  -H "Authorization: Bearer $MXB_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"gpt-5.5","input":"给一张茶壶产品图写一句标题。","stream":false}'

字段	类型	说明
model	string，必填	具有 Responses 支持与权限的目标型号
input	string 或协议输入数组	最小文本请求直接使用字符串
instructions	string，可选	模型支持时使用的指令，不是 messages 数组
stream	boolean，可选	true 使用 Responses 事件流
max_output_tokens	integer，可选	支持时限制输出，不使用 Chat 的 max_tokens 替代
previous_response_id / tools 等	可选	不构成本站所有模型统一可用的会话与工具承诺，确认支持后再用

原始 HTTP JSON 应遍历 output 数组中的 message 项，再读取 content 中 type=output_text 的 text。不要假定顶层必然有 SDK 提供的 output_text 便捷属性。

javascript

const texts = [];
for (const item of response.output || []) {
  if (item.type !== 'message') continue;
  for (const part of item.content || []) {
    if (part.type === 'output_text' && typeof part.text === 'string') texts.push(part.text);
  }
}
const answer = texts.join('\n');

以上是响应解析片段，response 需要替换成你已接收的真实 JSON。还要处理 status、error 和 incomplete_details 等实际返回字段；不能把空文本一律视为成功。

SSE 流式文本

模型支持时设置 stream:true，使用 curl 的 --no-buffer 观察事件：

bash

curl --no-buffer --fail-with-body --max-time 180 \
  https://openpix.cc/v1/chat/completions \
  -H "Authorization: Bearer $MXB_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"写一句产品介绍"}],"stream":true}'

客户端必须按 SSE 的事件边界解析，不能把一个网络 chunk 当成一段完整 JSON。一个事件可能跨多个 chunk，同一个 chunk 也可能包含多个事件；使用连续的 UTF-8 解码器处理跨块字符。

Chat Completions 常见 data: JSON，从 choices[].delta.content 累积文本，以 [DONE] 或相应结束逻辑收尾。工具增量需要单独拼接。
Responses 使用事件 type，例如文本增量和完成事件；不要拿 Chat 的 choices 解析器硬套。
连接建立后仍可能出现错误事件。HTTP 200 不保证整个流已完整结束。
中途断线时保留已收内容并标记不完整，不自动重发完整生成请求。
流中的 usage 可能缺省或只在结束时出现，不要按已显示字符数推算最终费用。

参数错误与重试

400 一般先检查字段适配、上下文长度和请求结构；401/403 检查 Key 和权限；429 根据响应提示控制并发；5xx 或连接中断时先判断是否已有输出或请求记录。

语言生成同样可能产生“提交已受理但客户端没拿到完整响应”的情况。不要让 SDK、代理或队列无条件自动重试收费 POST。记录本站 request_id（若有）、型号、时间和错误摘要，避免记录完整 Key。

费用与边界

输入、输出、缓存以及长上下文阶梯可能分别计价。某些型号有 service_tier 等影响价格的参数，只有明确需要且当前支持时再设置。完整计费说明见分组与计费。

本章提供当前本站入口和协议说明，不代表本次对全部语言型号的高级能力重新执行了付费测试。音频、Embedding、Realtime 等未在本手册列出的业务，不应仅根据某个通用 SDK 存在相应方法就认定本站已提供。

新上型号、工具与计费专章

语言型号与阶梯费用补全GPT Pro六个型号、Grok Heavy三型号及上下文阈值、缓存、Astra优先档。已验证的AS Gemini工具调用与原生视频理解见AS Gemini，提供可下载的完整Python示例。