执行摘要

• 一句话：文档化通过渲染端点获取 Responses prompt token ID
• 推荐动作：不需要精读源代码，适合 Responses API 与 scale-out 部署用户作为操作手册阅读。值得关注的设计决策有两点：一是把“无状态渲染 + 请求前 token 预检”定位为模型副本路由前的标准动作，二是明确写出渲染端与生成端配置必须一致、多模态负载需要原样保留这两个容易被忽略的约束。文档价值中等，技术洞察有限。

功能与动机

作者在 PR body 中说明：前端当前已经能从 /v1/responses/render 获取 prompt token ID（实现见 #50195），本文档的目标是展示如何在选择模型副本之前使用该端点检查 token ID；同时它是 #40556 的 follow-up，并补充说在 9 月 8 日做了查重，确认没有其他 open PR 在记录同一工作流。

实现拆解

1. 在 docs/serving/online_serving/renderer.md 中新增“Get Responses prompt token IDs”章节，说明 /v1/responses/render 与 /v1/responses 共用 prompt 构建逻辑但不执行推理，并强调三个关键约束：端点无状态（支持内联历史但不支持 previous_response_id）、渲染端与生成 worker 必须使用相同的 model、tokenizer、chat template 与预处理配置、多模态请求的 GenerateRequest 负载必须原样转发给生成服务。章节内还加入了 VLLM_ENABLE_SCALE_OUT_ENDPOINTS=1 启动示例和 curl 配合 jq 提取 token_ids 的示例。
2. 更新 docs/serving/online_serving/README.md 的 Renderer APIs 概览，把原来单纯的“见 renderer.md 链接”扩展为通用能力描述：渲染器会在不运行推理的情况下完成 tokenization、模型特定 prompt 格式化与多模态预处理，并返回 prompt token ID、采样参数与处理后的多模态输入。这一修改吸收了两条 review 意见：删除了多余的单行提示，改用更通用的功能说明。
3. 在 docs/serving/online_serving/openai_compatible_server.md 的 Responses API 章节添加交叉引用，指向 renderer.md#get-responses-prompt-token-ids，并注明该场景下不需要单独的 /tokenize 调用。
4. 验证配套：作者声明已通过 pre-commit、两个 Bash 示例均通过 bash -n、示例 JSON 可解析为 ResponsesRequest、两个 jq 过滤器在样例 payload 上返回预期结果；由于本机 macOS 无法推断支持的设备，live 示例未实机验证，也没有在本地跑完整 docs build。该 PR 无测试、配置或 schema 改动。

关键文件：

• docs/serving/online_serving/renderer.md（模块 服务文档；类别 docs；类型 documentation）: 本 PR 的核心变更文件，新增“Get Responses prompt token IDs”章节，给出 /v1/responses/render 的使用场景、服务端启动示例、curl 与 jq 提取示例、认证说明及配置一致性注意事项。
• docs/serving/online_serving/README.md（模块 服务文档；类别 docs；类型 documentation）: 根据 review 意见重新组织 Renderer APIs 概览，从单一链接改为通用能力描述，直接承接两条 DarkLight1337 评论的修改结果。
• docs/serving/online_serving/openai_compatible_server.md（模块 服务文档；类别 docs；类型 documentation）: 在 Responses API 文档中补充指向 renderer.md 锚点的交叉引用，明确无需单独调用 /tokenize，是本工作流在 API 文档入口处的落地。

关键符号：未识别

评论区精华

DarkLight1337 对 docs/serving/online_serving/README.md 提出两条 review 意见：

• 针对在 derenderer 区块下方新增的“For Responses API input, use /v1/responses/render to get prompt token IDs”一行，评价为“I think this part isn't really needed.”，认为该行放在此处多余。

• 随后在同一条线程中建议“You could use a more general explanation of Renderer APIs containing more functionality”，即用更通用的渲染器 API 功能说明代替单点提示。
  作者采纳了两条意见：最终 README 版本删除了多余行，改为描述渲染器在 tokenization、prompt 格式化与多模态预处理方面的通用能力，并保留指向 renderer.md 指南的链接。之后 chaunceyjiang 回复“Thanks~”并批准，DarkLight1337 也批准合并。

• README 中新增行是否多余 (documentation): 作者按建议移除了该行，并将同一区域改写为更通用的 Renderer APIs 功能说明。

• 用更通用的 Renderer API 说明替代单点提示 (documentation): 作者采纳建议，最终 README 中 Renderer APIs 介绍扩展为 tokenization、prompt 格式化、多模态预处理等通用能力描述，并保留指向 renderer.md 的链接。

风险与影响

• 风险：整体风险极低，因为变更仅涉及文档，没有触碰任何代码、配置或测试路径。需要注意的风险点包括：
  • 文档示例依赖 /v1/responses/render 的当前行为与 VLLM_ENABLE_SCALE_OUT_ENDPOINTS=1 环境变量；若未来端点接口或默认开关发生变化，示例可能过期，需要与外层 scale-out 功能文档同步维护。
  • 作者明确说明 live 示例未在真实 GPU 服务器上端到端验证，示例中的 curl 命令与 jq 过滤器只经过本地语法和样例 payload 校验，实际服务端行为仍以 #50195 的实现为准。
  • 交叉引用依赖 renderer.md 的锚点 #get-responses-prompt-token-ids，后续若调整标题结构需要同步更新引用。
  • 影响：对用户：为使用 Responses API 或 scale-out 部署的用户提供了一个可操作的工作流，可以在路由到模型副本前直接查看渲染后的 prompt token ID 或 token 数量，无需额外调用 /tokenize。对系统：无任何运行时行为变化，不影响性能、安全或兼容性。对团队：3 个文档文件共 +44/-3 行，维护成本很低，但提升了渲染器文档在 Responses API 场景下的可发现性，并明确了“配置必须两端一致”这一关键使用约束。
  • 风险标记：文档示例依赖端点行为, live 示例未实机验证, 交叉引用依赖锚点

关联脉络

• PR #50195 N/A（材料未提供原始标题，语义推断为 Responses render 端点实现）: PR body 明确说明 frontends can already get Responses prompt token IDs from /v1/responses/render, added in #50195，本 PR 是基于该功能的文档补充。
• PR #40556 N/A（材料未提供原始标题，语义推断为早期 Responses 相关功能或文档）: PR body 标注本 PR 为 follow-up to #40556，具体内容未在材料中体现，仅能确认存在后续关系。