开始使用
接口选择
分清根地址、/v1 基址和完整接口,避免重复路径与协议混用。
先确认应用需要哪一种地址#
| 填写位置 | 地址 | 说明 |
|---|---|---|
| OpenAI 兼容客户端 / Codex 自定义 provider | https://lensapi.top/v1 | 客户端继续追加具体接口路径。 |
| Claude Code 的 ANTHROPIC_BASE_URL | https://lensapi.top | 不添加 /v1;由 Claude Code 追加 Messages 路径。 |
| 直接发送 HTTP 请求 | 基址加对应接口路径 | 例如 https://lensapi.top/v1/responses。 |
不要把文档地址、控制台地址或完整聊天接口填到“Base URL”字段里。出现 /v1/v1/… 或重复的 /chat/completions 时,通常是客户端自动拼接与手动填写发生了重复。
按照任务选择接口#
| 用途 | 接口 | 使用条件 |
|---|---|---|
| GPT 文本对话 | POST /v1/chat/completions | Codex-Pro 中支持该接口的模型。 |
| Codex / Responses 请求 | POST /v1/responses | Codex-Pro 中列有 Responses 的模型。 |
| Claude Code | 客户端使用 /v1/messages | CC-MAX 仅限 Claude Code,不作为通用脚本入口。 |
| 图片生成 | POST /v1/images/generations | Image-2 中的图片模型。 |
两种文本协议的字段不同#
Chat Completions 使用 messages;Responses 使用 input。先使用最小请求,确认成功后再加入额外参数。不要只改 URL、却保留另一种协议的整个请求体。
Chat Completions 请求体#
{
"model": "gpt-5.5",
"messages": [{"role": "user", "content": "你好"}],
"stream": false
}
Responses 请求体#
{
"model": "gpt-5.5",
"input": "你好",
"stream": false
}
不要根据名称推断接口能力#
模型出现在目录中,不代表所有协议、工具、图片编辑或视频接口都可以使用。以该模型当前列出的接口为起点,再验证你的实际任务。图片生成与 Claude Code 各有专用教程;如需其他能力,请先确认,避免把生产请求直接迁移过去。