text-embedding-3

OpenAI API 嵌入错误导致静默失败，需要契约测试

OpenAI API 的嵌入端点可能由于向量维度和编码格式的不一致而导致静默失败。与聊天补全不同，嵌入错误不会抛出异常，这使得检索质量下降看起来像是提示或分块问题。为防止这种情况，开发人员应实施契约测试，明确检查向量形状、维度长度和编码格式（float vs. Base64），因为 Python SDK 的默认行为可能与 API 文档不同。