站长注：详细解析 Gemini API 在对话中出现 contents.parts must not be empty 错误的原因，以及如何正确处理多模型对话切换的问题。
在使用 Gemini API 进行开发时，可能会遇到 contents.parts must not be empty 这个错误。本文将通过实际案例，特别是在 Cherry Studio 中的使用场景，详细解释这个错误的原因和解决方案。
欢迎免费试用 API易，3 分钟跑通 API 调用 www.apiyi.com
支持 Gemini、Claude、Deepseek 等全系列模型，让 AI 开发更简单
注册即送 1.1 美金额度起。立即免费注册 www.apiyi.com
Cherry Studio 与多模型切换
Cherry Studio 简介
Cherry Studio 是一款功能强大的多模型 AI 桌面客户端，具有以下特点：
- 丰富的模型支持
- 集成超过 300 个大语言模型
- 支持主流 AI 服务（OpenAI、Gemini、Anthropic 等）
- 支持本地模型部署
- 多模型切换功能
- 可在同一界面切换不同模型
- 支持跨模型对话
- 保留历史对话记录
模型切换的挑战
在 Cherry Studio 这样的多模型客户端中，一个常见的使用场景是在同一个对话中切换不同的模型。然而，这种切换可能会导致一些技术问题：
- 格式兼容性
- 不同模型使用不同的消息格式
- 历史记录格式可能不兼容
- 切换时需要格式转换
- 会话管理
- 同一会话中混用多个模型
- 历史记录的连续性
- 状态保持的问题
Gemini API 错误案例分析
错误现象
在 Cherry Studio 中切换到 Gemini 模型时，可能会遇到以下错误：
{
"status_code": 400,
"error": {
"message": "",
"type": "",
"code": 400
}
}
具体错误信息：
失败原因是:[&{{* GenerateContentRequest.contents.parts: contents.parts must not be empty.
* GenerateContentRequest.contents.parts: contents.parts must not be empty.
* GenerateContentRequest.contents.parts: contents.parts must not be empty.
* GenerateContentRequest.contents.parts: contents.parts must not be empty.
问题场景
问题出现在以下情况：
- 对话历史：
{
"model": "gemini-2.0-flash-exp",
"messages": [
{
"role": "user",
"content": "请画一张图，小比熊踮起脚尖，在抢食物"
},
{
"role": "assistant",
"content": ""
},
{
"role": "user",
"content": "你是什么模型"
},
{
"role": "assistant",
"content": ""
}
// ... 更多对话历史
]
}
- 关键问题：
- 在同一个对话中切换了不同的模型
- 存在空的 content 字段
- 对话历史格式不一致
Gemini API 错误原因分析
1. 模型切换问题
Gemini API 对对话历史的格式有严格要求：
- 格式一致性
- 所有消息必须符合 Gemini 的格式规范
- 不能混用不同模型的消息格式
- 内容完整性
- 每条消息的 parts 字段不能为空
- content 必须包含有效内容
2. 消息格式差异
不同模型的消息格式存在差异：
- OpenAI 格式
{
"role": "assistant",
"content": "消息内容"
}
- Gemini 格式
{
"role": "model",
"parts": [{
"text": "消息内容"
}]
}
3. 历史记录问题
在切换模型时：
- 之前的对话历史格式可能不兼容
- 空的 content 字段导致转换失败
- 消息结构不符合新模型要求
Gemini API 解决方案
1. 正确的调用方式
def call_gemini_api(prompt, history=None):
# 创建新的对话
messages = [{
"role": "user",
"parts": [{
"text": prompt
}]
}]
# 如果需要历史记录，确保格式转换
if history:
messages = convert_history_format(history)
response = requests.post(
"https://vip.apiyi.com/v1/chat/completions",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
},
json={
"model": "gemini-2.0-flash-exp",
"messages": messages
}
)
return response.json()
2. 最佳实践建议
- Cherry Studio 使用建议
- 切换模型时建议开启新会话
- 避免在同一对话中频繁切换模型
- 重要对话保持单一模型
- 新会话处理
- 切换模型时启动新会话
- 不要在同一会话中混用模型
- 格式转换
- 确保所有消息符合目标模型格式
- 处理空内容的情况
- 历史记录管理
- 分别存储不同模型的对话历史
- 切换模型时清理历史记录
3. 代码实现示例
def convert_history_format(history):
"""转换历史记录格式"""
converted = []
for msg in history:
if msg["content"]: # 只处理非空内容
converted.append({
"role": "user" if msg["role"] == "user" else "model",
"parts": [{
"text": msg["content"]
}]
})
return converted
def create_new_conversation(model):
"""创建新会话"""
return {
"model": model,
"messages": [],
"created_at": datetime.now()
}
常见问题解答
1. 为什么会出现这个错误？
- 模型切换导致格式不兼容
- 历史记录中存在空内容
- 消息结构不符合 Gemini 要求
2. 如何避免这个问题？
- 切换模型时创建新会话
- 确保所有消息内容非空
- 统一消息格式
3. 最佳处理方式是什么？
- 使用模型专用的会话管理
- 实现格式转换功能
- 做好错误处理
总结
在使用 Gemini API 时，特别是在 Cherry Studio 这样的多模型客户端中，遇到 contents.parts must not be empty 错误主要是由于：
- 原因分析
- Cherry Studio 的多模型切换机制
- 消息格式不兼容
- 存在空内容
- 解决方案
- 使用新会话进行模型切换
- 避免在同一对话中混用模型
- 保持单一模型的对话连续性
- 使用建议
- 在 Cherry Studio 中谨慎使用模型切换功能
- 重要对话建议使用单一模型
- 需要切换时创建新会话
通过本文的分析和解决方案，你应该能够更好地在 Cherry Studio 中使用 Gemini API，避免因模型切换导致的错误。记住，虽然 Cherry Studio 支持多模型切换，但在某些情况下，创建新的会话是更安全的选择。
欢迎免费试用 API易，3 分钟跑通 API 调用 www.apiyi.com
支持 Gemini、Claude、Deepseek 等全系列模型，让 AI 开发更简单
本文作者：API易团队
欢迎关注我们的更新，持续分享 AI 开发经验和最新动态。
