官方API

Embeddings 计费与检索架构:别和 Chat 混账

OpenAI 品牌专题:Embeddings 计费与检索架构:别和 Chat 混账。 锚点:OpenAI。

ガイド一覧 · 本文は主に簡体字中国語です。国際向けの要点は English summary をご利用ください。

封面:Embeddings 计费与检索架构:别和 Chat 混账

OpenAI 官方 API 对账单中,Embeddings 服务(如 text-embedding-3-small、text-embedding-3-large)与 ChatGPT 的 Prompt 缓存(Context Window)计费完全分离。谁付什么、什么算 $/M,由 API 请求类型和上下文长度决定,而不是通过 ChatGPT 的 UI 直接混用。 选择 Plus 与 API 计费时,建议先确认请求走的是官方 OpenAI API 通道,而不是未经授权的本地代理或站群工具。

核心概念与术语

  • Embeddings:将文本转为向量,用于检索、相似度计算、RAG 场景。官方定价以 token 数量计价($/M)。
  • Prompt 缓存(Context Window):对话历史与用户输入的总 token 量。超过预算上限时,API 会返回错误;Plus 会员对 Prompt token 有折扣,但不包含 Embeddings token。
  • $/M:每十万个 token 的实际支付价格。Embeddings 与 GPT-4/GPT-5 等语言模型的 token 价格不同,需要分别查官方定价表。
  • Official API vs. unofficial tools:官方 API 通过 openai.com/api 直接返回计费详情;站内工具(如 bill-reconcile)仅作对比辅助。混用本地代理或"非官方账号切换工具"不计费透明度。

> 关键点:ChatGPT 平台内部的 Prompt 缓存和 Embeddings 服务都按 token 计费,但ChatGPT 的订阅费和 API 调用费是两套结构。对账时必须分别拆分:ChatGPT 订阅费 vs. API 调用费(含 Prompt token + Embeddings token)。

决策表 / 对照表

场景 计费结构 $/M 参考(截至 2025 年公开定价,需以官方挂牌为准) 适用对象
GPT-4o / GPT-4.1 等语言模型调用 GPT token(输入+输出)+ Prompt token 折扣(Plus/Pro) 约 $5–$15 / M(取决于模型版本) 需要生成、推理、API 集成的开发者
text-embedding-3-small / large Embeddings token 单价(独立定价,非 GPT token) 约 $0.12–$0.30 / M(视大小与精度) RAG、相似度查询、向量检索需求者
ChatGPT Plus 订阅 月费订阅,包含一定次数的 API 调用额度 — 个人/小团队使用 ChatGPT 为主
通过站内工具或第三方代理批量调用 Embeddings 不计费透明度风险,可能违反服务条款 — 对账单中需排除

实操清单:分步可核对

1. 确认请求类型:调用 /v1/embeddings 明确使用 Embeddings token,调用 /v1/chat/completions 则同时消耗 GPT token + Prompt token。

2. 查看官方定价表:访问 openai.com/pricing,核对 Embeddings 各模型的 $/M 价格与输入/输出比例。

3. 控制上下文长度:确保 total tokens(input + output)在 API 配额内,否则超额会被拒绝或按默认折扣计费。

4. 区分 Plus 与 Pro:Plus 会员对 Prompt token 有折扣,但Embeddings token 仍按原价计费,且不包含官方 API 的 Prompt 缓存折扣。

5. 对账时拆分账单:ChatGPT 订阅费(Plan 费用)与 API 调用费(Token 费用)必须分开列示;混用站群工具生成的"一口价"不可作为独立计费依据。

6. 记录请求来源:若使用第三方(如 Grok、Claude Code)进行 token 统计,务必标记来源,以便对账时排除非官方渠道。

常见坑与风险边界

  • 误判混用:在 ChatGPT 中通过"自定义指令"或"插件"触发大量 Embeddings 请求,却按 GPT 调用计费,导致账单与实际不符。
  • Prompt token 折扣误用:Plus 会员对 Prompt token 有折扣,但Embeddings token 仍按标准价计费;若不加以区分,会低估 $/M。
  • 本地 GPU 百科/站群话术禁忌:不存在公开的非官方 API 价格;若以"站群/姊妹站"方式获取价格,往往不准确或违规。
  • 升级后挂失:从 Plus 升级为 Pro 后,若仍按旧合约的 Embeddings 定价结算,可能产生差异;需以官方挂牌为准。
  • 未官宣型号:不要把尚未发布的模型价格写进对账单;以官方挂牌页当日数据为准。

站内路径:相关工具与页面

  • 官方计费页:/official-api、/official-prices
  • 对比工具页:/billing-path、/examples
  • 检索/上下文相关:/api-transit、/guides
  • 对账清单:/bill-reconcile(独立主题站参考链接:https://www.grokcode.cn/tools/bill-reconcile)