openai-docs skill 最新模型指南掌握 OpenAI 模型选型映射与动态刷新机制【免费下载链接】skillsSkills Catalog for Codex项目地址: https://gitcode.com/GitHub_Trending/skills4/skills导读openai-docs是 Codex skills 目录中负责 OpenAI 官方文档检索、Codex 自身知识问答、模型选型与模型迁移建议的 skill见 SKILL.md。本篇文章围绕该 skill 内置的模型选型助手文档 latest-model.md 展开系统讲解其中维护的完整模型 ID 映射表、各模型的使用定位以及该表在 skill 工作流中如何被脚本化地解析、校验与刷新。读完本文你将掌握如何依据任务类型编码、图像、语音、实时会话、嵌入等快速选择正确的模型 IDgpt-5.5系列与gpt-5.3-codex系列之间的定位差异以及以官方文档为准、本地映射仅作兜底的 freshness 校验机制是如何通过resolve-latest-model-info.js实现的。一、latest-model.md 在 skill 中的定位模型选型的本地兜底在 SKILL.md 的 Workflow Configuration 中明确写明了该文档的用途For model-selection, latest model, or default-model questions, fetchhttps://developers.openai.com/api/docs/guides/latest-model.mdfirst. If that is unavailable, loadreferences/latest-model.md.也就是说当用户询问当前最新模型默认模型该用哪个模型这类问题时skill 优先拉取官方最新模型指南只有官方页面不可用或取不到时才会回退到仓库内打包的references/latest-model.md。因此该文档被明确定位为bundled fallback reference本地兜底参考其价值不在代替官方文档而在断网/降级场景下仍然给出方向正确的模型映射。这一设计也解释了文档开篇那句醒目的声明latest-model.mdThis file is a curated helper. Every recommendation here must be verified against current OpenAI docs before it is repeated to a user.即本文件是人工整理curated的助手型参考任何推荐在转述给用户之前都必须与当前 OpenAI 官方文档核对。二、完整模型映射表23 个模型 ID 的分工与选型依据latest-model.md的核心资产是一张模型 ID → 适用场景映射表latest-model.md下面完整复刻并逐类解读Model IDUse for用途定位gpt-5.5大多数新应用的最新/默认文本与推理模型包括编码和重度工具调用工作流gpt-5.5-pro在延迟与成本不那么敏感时追求最大化推理质量gpt-5.4上一代默认文本与推理模型用于既有 GPT-5.4 集成gpt-5.4-mini低成本测试与更轻量的生产工作流gpt-5.4-nano高吞吐的简单任务与分类gpt-5.5通过reasoning.effort: none显式关闭推理的纯文本路径gpt-4.1-mini更便宜的纯文本no-reasoning方案gpt-4.1-nano最快且最便宜的纯文本no-reasoning方案gpt-5.3-codexAgentic 编码、代码编辑与重度工具调用编码工作流gpt-5.1-codex-mini更便宜的编码工作流gpt-image-2最佳图像生成与编辑质量gpt-image-1.5图像生成与编辑的性价比选择gpt-image-1-mini成本优先的图像生成gpt-4o-mini-tts文本转语音TTSgpt-4o-mini-transcribe语音转文本快速且成本高效gpt-realtime-1.5实时语音与多模态会话gpt-realtime-mini更便宜的实时会话gpt-audioChat Completions 的音频输入与输出gpt-audio-mini更便宜的 Chat Completions 音频工作流sora-2快速迭代与草稿视频生成sora-2-pro更高质量的成片级视频omni-moderation-latest文本与图像内容审核text-embedding-3-large更高质量的检索嵌入该 skill 将其作为默认无更优专属行text-embedding-3-small更便宜的嵌入2.1 选型要点解读从这张表可以提炼出几条直接的选型经验默认首选gpt-5.5绝大多数新应用、编码场景、工具调用密集的工作流都以它作为默认入口它是表内唯一同时覆盖文本 推理 编码/工具三条线的主力模型。质量优先走gpt-5.5-pro当延迟与成本约束放宽、需要最大推理质量时选择 pro 变体。成本/吞吐分层gpt-5.4-mini、gpt-5.4-nano、gpt-4.1-mini、gpt-4.1-nano构成低成本测试 / 高吞吐简单任务 / 纯文本的降级路径其中gpt-4.1-nano定位为最快最便宜的纯文本方案。关闭推理的显式路径表中特别标注gpt-5.5可通过reasoning.effort: none走无推理文本路径这说明是否推理是一个可参数化的行为开关而不是一个独立模型 ID。编码任务单独成线gpt-5.3-codex与gpt-5.1-codex-mini专门面向 agentic 编码、代码编辑与工具调用密集工作流与通用gpt-5.5形成编码专用 / 通用的双轨。多模态与专用能力分域图像gpt-image-*、语音合成gpt-4o-mini-tts、语音识别gpt-4o-mini-transcribe、实时会话gpt-realtime-*、音频对话gpt-audio*、视频sora-2*、审核omni-moderation-latest、嵌入text-embedding-3-*各自独立不应混用。嵌入默认选择有据可依表内为text-embedding-3-large专门注明该 skill 内默认使用它因为不存在更优的专属行——这是文档对自己选型逻辑的显式交代。三、脚本化解析resolve-latest-model-info.js 如何消费模型信息latest-model.md之所以能作为可编程的兜底参考是因为 skill 提供了配套的解析脚本 resolve-latest-model-info.js它并不解析本仓库的latest-model.md而是以相同约定解析官方最新模型指南页中内嵌的latestModelInfo元数据块将模型信息标准化输出为 JSON。3.1 元数据解析逻辑脚本extractLatestModelInforesolve-latest-model-info.js支持两种元数据形态缩进块形态形如latestModelInfo:后跟两空格缩进的key: value行由parseIndentedInfo解析HTML 注释形态形如!-- latestModelInfo ... --包裹的扁平key: value行由parseFlatInfo解析。随后normalizeInforesolve-latest-model-info.js做三件事要求model、migrationGuide、promptingGuide三个字段必须齐全缺失即抛错防止下游拿到残缺信息调用modelToSkillSlug把模型 ID 转成 slug点号替换为字母 p例如gpt-5.5→gpt-5p5见 resolve-latest-model-info.js基于可配置的baseUrl将迁移指南与提示词指南的相对路径解析为绝对 URL。3.2 输入来源与环境变量脚本通过parseArgsresolve-latest-model-info.js支持两种参数来源环境变量LATEST_MODEL_URL默认指向官方 latest-model.md 页面、LATEST_MODEL_BASE_URL默认https://developers.openai.com命令行参数--source/--url指定来源--base-url指定拼接基址。readSourceresolve-latest-model-info.js统一支持file://本地文件、普通本地路径、http(s)://远程地址三种来源远程抓取时会显式携带accept: text/markdown,text/plain,*/*请求头——这也是该脚本可用于本地复现验证的体现。执行示例# 从默认官方地址抓取并解析最新模型信息 node skills/.curated/openai-docs/scripts/resolve-latest-model-info.js # 指定自定义来源与基址 node skills/.curated/openai-docs/scripts/resolve-latest-model-info.js \ --source ./latest-model.md --base-url https://developers.openai.com3.3 输出约定与 skill 工作流的衔接脚本标准输出一个 JSON 对象形如{ model: gpt-5.5, modelSlug: gpt-5p5, migrationGuideUrl: https://developers.openai.com/.../migration-guide, promptingGuideUrl: https://developers.openai.com/.../prompt-guidance }该输出被 SKILL.md 直接消费仅在目标为最新/当前/默认这类未指定模型时才运行此脚本如果用户显式指名目标例如迁移到 GPT-5.4则必须保留用户指定目标即使映射表里已有更新的模型也只能把新模型作为可选项提及。这一保留显式请求、不擅自越权升级的约束正是该 skill 质量规则的一部分。四、freshness 机制映射表如何防漂移latest-model.md的 Maintenance noteslatest-model.md只有两条却是整个 skill 信息可靠性的基石This file will drift unless it is periodically re-verified against current OpenAI docs.If this file conflicts with current docs, the docs win.即该表若不定期与官方文档复核就必然漂移drift一旦与官方文档冲突以官方文档为准。与之配套的是 upgrade-guide.md 中定义的 freshness check新鲜度检查流程升级到最新/当前/默认模型前先从 skill 目录运行node scripts/resolve-latest-model-info.js若返回modelSlug: gpt-5p5说明官方元数据与本地兜底一致继续使用本地latest-model.md与prompting-guide.md若返回不同的modelSlug则必须改以返回的migrationGuideUrl与promptingGuideUrl对应内容为准若脚本失败、元数据缺失或远程指南抓取失败才回退到本地兜底参考并明确告知远程新鲜度检查不可用。这一机制的实质是官方优先、脚本仲裁、本地兜底、冲突时文档胜出的四级信息降级链。也正是因为本地表随时可能过期文档反复强调任何推荐在转述前都必须与官方文档核对——本仓库内的 SKILL.md 质量规则同样要求Treat OpenAI docs as the source of truth; avoid speculation以 OpenAI 文档为真相来源避免臆测。五、与配套文档的协同选型 → 迁移 → 提示词latest-model.md不是孤立存在它与同目录下另外两份参考文档构成完整的选型-迁移-提示词链条references/latest-model.md回答该选哪个模型references/upgrade-guide.md回答如何把已有集成升级到gpt-5.5——默认目标字符串为gpt-5.5并给出model string only、model string light prompt rewrite、blocked三档升级结果分类以及 8 项兼容性检查清单含 Responses 流程中phase是否保留的检查references/prompting-guide.md回答升级后提示词怎么写——强调 GPT-5.5 更适合结果导向outcome-first的短提示、显式停止条件、检索预算retrieval budget、引用纪律以及text.verbosity与phase: commentary/phase: final_answer等参数化行为。三者的协作顺序在 SKILL.md 的 Workflow 中有明确表述先澄清请求类型通用文档查询 / 模型选型 / 模型字符串升级 / 提示词升级 / 更大范围的迁移模型升级时保持变更面最小——只替换模型字符串和直接相关的提示词不自动升级历史文档、示例、eval 基线、低成本的兜底路由等可能被刻意固定pinned的旧模型用法凡需要 API 表面变更、schema 重接线、工具处理器改造的升级一律标记为 blocked 或需确认。六、如何在本仓库中继续深入如果你希望进一步验证本文涉及的内容可以在仓库内按以下路径继续阅读模型映射表全文references/latest-model.mdskill 完整工作流与来源优先级SKILL.md元数据解析脚本slug 转换、字段校验、远程/本地来源支持scripts/resolve-latest-model-info.jsCodex 手册抓取助手同属该 skill 的缓存与大纲生成脚本scripts/fetch-codex-manual.mjs升级指南与提示词指南references/upgrade-guide.md、references/prompting-guide.mdskill 的 agent 接口描述与 MCP 依赖声明agents/openai.yaml。结语latest-model.md虽然只是一张映射表加两条维护说明但它完整承载了模型选型这一高频问题的兜底答案23 个模型 ID 覆盖文本/推理、编码、图像、语音、实时、视频、审核、嵌入八大能力域配合resolve-latest-model-info.js的元数据解析与upgrade-guide.md的 freshness 检查构成了一个官方优先、脚本仲裁、本地兜底的可靠信息链。理解这张表与其刷新机制是正确使用gpt-5.5系列、规划模型迁移、以及编写适配新一代推理模型提示词的第一步。【免费下载链接】skillsSkills Catalog for Codex项目地址: https://gitcode.com/GitHub_Trending/skills4/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考