API 参考

Chat Completions

使用 messages 组织多轮对话，并从 choices 读取文本响应。

POSThttps://lensapi.top/v1/chat/completions

适用于 Codex-Pro 中支持 Chat Completions 的模型。SDK Base URL 为 https://lensapi.top/v1。

请求结构#

字段	类型	说明
`model`	string	完整模型 ID。
`messages`	array	按对话顺序排列，每项包含 role 与 content。
`stream`	boolean	设为 true 请求流式输出，见流式响应。

温度、最大输出、结构化输出及工具参数的支持取决于具体模型。先完成最小请求，再逐项加入所需字段。

多轮对话示例#

安装 SDK 与设置密钥见快速开始。此例会发起两次请求：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["LENSAPI_API_KEY"],
    base_url="https://lensapi.top/v1",
)
messages = [{"role": "user", "content": "推荐一种保存配置的文本格式。"}]
first = client.chat.completions.create(model="gpt-5.5", messages=messages)
answer = first.choices[0].message.content
print(answer)

messages.append({"role": "assistant", "content": answer or ""})
messages.append({"role": "user", "content": "给我一个最小示例。"})
second = client.chat.completions.create(model="gpt-5.5", messages=messages)
print(second.choices[0].message.content)

第二次请求显式携带历史消息，历史内容也属于该次输入。

读取响应#

非流式文本通常位于 choices[0].message.content。finish_reason 表示输出结束原因；若响应提供 usage，可用于客户端用量记录。实际扣费以站内日志为准。

加入工具调用后，检查返回类型并等待工具参数完整，由业务逻辑控制执行权限，不要假定响应只有纯文本。

迁移已有应用#

替换为 Codex-Pro Key。
修改 Base URL 为 https://lensapi.top/v1。
模型 ID 使用本站目录中的准确值。
分别测试短请求、流式、工具和长上下文等实际流程。

失败时保留 HTTP 状态及脱敏错误消息，按错误排查处理。