API错误处理实战：解析与解决`reasoning_content`导致的400错误(DeepSeek)

1次阅读

共计 2308 个字符，预计需要花费 6 分钟才能阅读完成。

HTTP 400 错误与 `reasoning_content` 字段

HTTP 400 状态码表示 ”Bad Request”，即服务器无法理解客户端发送的请求。在 DeepSeek API 中，当出现 api error: 400 error from provider (deepseek): the 'reasoning_content' in th 这样的错误时，通常意味着请求中的 reasoning_content 字段存在问题。

reasoning_content是 DeepSeek API 中的一个关键字段，它包含了模型进行推理所需的核心内容。这个字段的正确构造直接关系到 API 调用的成功与否。

字段缺失 ：请求体中完全缺少reasoning_content 字段
格式错误：字段值不符合 API 要求的 JSON 格式
长度超标：内容超过了 API 允许的最大长度限制
编码问题：包含非法字符或编码不正确
类型错误：字段值不是预期的字符串类型

import json
import requests
from requests.exceptions import RequestException
import logging

# 配置日志
logging.basicConfig(
    level=logging.INFO,
    format='%(asctime)s - %(levelname)s - %(message)s'
)
logger = logging.getLogger(__name__)

# DeepSeek API 配置
API_URL = "https://api.deepseek.com/v1/complete"
API_KEY = "your_api_key_here"

# 构造合规的请求体
def build_valid_request():
    return {
        "reasoning_content": "请用不超过 100 字总结这篇文章的主旨",
        "model": "deepseek-chat",
        "temperature": 0.7,
        "max_tokens": 100
    }

# 发送 API 请求
def call_deepseek_api():
    headers = {"Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }

    try:
        payload = build_valid_request()
        response = requests.post(
            API_URL,
            headers=headers,
            data=json.dumps(payload),
            timeout=30
        )

        # 处理响应
        if response.status_code == 200:
            return response.json()
        else:
            logger.error(f"API 请求失败: {response.status_code} - {response.text}")
            # 针对 400 错误的特殊处理
            if response.status_code == 400 and 'reasoning_content' in response.text:
                logger.error("reasoning_content 字段存在问题，请检查格式和内容")
            return None

    except RequestException as e:
        logger.error(f"请求发生异常: {str(e)}")
        return None
    except json.JSONDecodeError as e:
        logger.error(f"JSON 解析错误: {str(e)}")
        return None

# 示例调用
if __name__ == "__main__":
    result = call_deepseek_api()
    if result:
        print("API 调用成功:", result)
    else:
        print("API 调用失败，请检查日志")

内容长度控制 ：始终检查reasoning_content 的长度，确保不超过 API 限制
字符编码统一：确保所有文本都使用 UTF- 8 编码，避免特殊字符问题
请求验证：在发送前使用 JSON Schema 验证请求体结构
重试机制：对于暂时性错误（如速率限制），实现合理的退避重试策略
日志完整：记录完整的请求和响应信息，便于排查问题

from time import sleep

def call_api_with_retry(max_retries=3, initial_delay=1):
    retry_count = 0
    delay = initial_delay

    while retry_count < max_retries:
        result = call_deepseek_api()
        if result is not None:
            return result

        retry_count += 1
        logger.info(f"第 {retry_count} 次重试，等待 {delay} 秒...")
        sleep(delay)
        delay *= 2  # 指数退避

    logger.error(f"达到最大重试次数{max_retries}，放弃请求")
    return None