OpenAI 模型与参数选择
按模型能力选择 Chat Completions、Responses、工具与推理入口。模型 ID 以青云TOP API 当前公开目录和你的 API Key 可见列表为准；目录存在不代表所有账号或所有协议组合都已开通。
当前模型目录
截至 2026-10-30，青云TOP API 公开 pricing 目录中的 OpenAI 文本模型代表性 ID 如下：
| 系列 | 代表性模型 ID | 适用提示 |
|---|---|---|
| GPT-6.1 | gpt-6.1-sol、gpt-6.1-terra | 新项目优先核对的通用模型；从最小 messages 请求开始 |
| GPT-6 | gpt-6-astra、gpt-6-sol、gpt-6-luna | Astra 适合复杂端到端任务，Sol/Luna 适合专业任务和高吞吐；以当前 Key 可见性为准 |
| GPT-5.6 | gpt-5.6、gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna | 复杂专业工作、编程、智能体和日常任务；不要自行拼接 -max 或 -ultra |
| GPT-5.x | gpt-5.5、gpt-5.5-pro、gpt-5.4、gpt-5.4-mini、gpt-5.4-nano | 固定快照、专业和轻量任务按实际目录选择 |
| 推理模型 | o4-mini、o3、o3-mini | 数学、分析、规划和编码；使用对应页面的推理参数 |
| 兼容模型 | gpt-4.1、gpt-4o | 兼容旧应用、识图、工具和结构化输出示例 |
公开目录还可能包含日期、preview、渠道或能力后缀；这些字符串是独立模型 ID。不要把一个账号的完整列表写死到应用，也不要把 gpt-image-* 图像模型填入聊天请求。
两步接入
使用青云TOP API 的 API Key：Authorization: Bearer YOUR_API_KEY。替换占位符并保留 Bearer 后的空格。
文本聊天使用 POST https://top.qingyuntop.ai/v1/chat/completions；新的多工具、后台和结构化工作流按 Responses 文档选择 POST /v1/responses。两种协议的 messages 与 input、工具和输出格式不能直接混用。
参数选择
新模型先采用最小请求：model、messages，以及确有需要时的 max_completion_tokens、stream、工具或结构化输出。不要把旧 GPT-4o 的全部采样参数套用到 GPT-6；o 系列不要继续发送旧的 max_tokens。reasoning_effort 的枚举和可用范围按具体模型与入口核对，不能由模型名称推断。
使用 GET /v1/models 查询当前 Key 可见的模型 ID，再根据对应页面确认 Chat、Responses、图片、视频或音频能力。403 通常表示模型或渠道权限不足；模型出现在公开目录中不等于当前 Key 已开通。
专用入口
图片理解、工具、结构化输出、推理控制、网页搜索、音频转写、语音合成和嵌入使用各自页面。gpt-4o-transcribe、gpt-4o-mini-transcribe、whisper-1 不填入聊天示例；gpt-image-2、gpt-image-2.5-flare、gpt-image-2.5-sunburst 进入绘画目录。