GH/DEEPSEEK_SETUP.md

DeepSeek大模型配置指南

概述

DeepSeek大模型是本项目的主要AI文案生成引擎，提供先进的创意文案生成能力。本指南将帮助您配置和使用DeepSeek大模型服务。

获取API密钥

步骤1：访问DeepSeek平台

1. 访问 DeepSeek开放平台
2. 注册账号并完成实名认证
3. 进入控制台，创建新的API密钥

步骤2：创建应用

1. 在控制台中点击"创建应用"
2. 填写应用名称（如：数据提取转换器）
3. 选择适用的模型（推荐：DeepSeek-V3）
4. 设置使用权限和配额

步骤3：获取API密钥

1. 在应用详情页面找到"API密钥"部分
2. 点击"生成新密钥"
3. 复制生成的API密钥（格式：sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx）

配置环境变量

编辑.env文件

在项目根目录下的.env文件中添加DeepSeek配置：

# DeepSeek大模型配置（主要AI文案生成）
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
DEEPSEEK_BASE_URL=https://api.deepseek.com

参数说明

• DEEPSEEK_API_KEY: 您的DeepSeek API密钥
• DEEPSEEK_BASE_URL: DeepSeek API服务地址（默认值已设置）

功能特性

主要功能

• 创意文案生成: 基于照片内容生成多种风格的文案
• 智能内容分析: 自动识别照片主题和关键元素
• 多风格支持: 支持商务、文艺、幽默等多种文案风格
• 长度控制: 可生成短、中、长三种长度的文案

模型特点

• 高准确性: 基于先进的深度学习模型
• 快速响应: 优化的API响应速度
• 中文优化: 专门针对中文内容进行优化
• 安全可靠: 企业级的安全保障

使用示例

在应用中启用DeepSeek

1. 确保.env文件中已配置正确的API密钥
2. 启动应用：uv run streamlit run app.py
3. 在"AI照片评分"功能中点击"AI写文案"
4. 选择文案风格和长度
5. 系统将使用DeepSeek大模型生成创意文案

代码调用示例

from utils.deepseek_copywriter import DeepSeekCopywriter

# 初始化DeepSeek客户端
copywriter = DeepSeekCopywriter()

# 生成文案
photo_description = "一张美丽的日落照片，有橙色的天空和剪影"
result = copywriter.generate_copywriting(
    description=photo_description,
    style="文艺",
    length="中等"
)

print(result)

故障排除

常见问题

1. API密钥无效

症状: 返回"Invalid API key"错误 解决方案:

• 检查API密钥格式是否正确（以sk-开头）
• 确认API密钥是否已激活
• 检查账户余额是否充足

2. 请求频率限制

症状: 返回"Rate limit exceeded"错误 解决方案:

• 降低请求频率
• 检查API配额和使用限制
• 联系DeepSeek客服调整配额

3. 网络连接问题

症状: 连接超时或网络错误 解决方案:

• 检查网络连接
• 确认防火墙设置
• 尝试使用代理服务器

调试方法

1. 检查配置: 运行配置检查脚本

   uv run python -c "from utils.deepseek_copywriter import check_deepseek_config; print(check_deepseek_config())"
   

2. 测试连接: 运行简单的API测试

   uv run python -c "from utils.deepseek_copywriter import DeepSeekCopywriter; c = DeepSeekCopywriter(); print(c.test_connection())"
   

成本估算

DeepSeek大模型的定价基于使用量：

• 输入Token: 约 ¥0.001/千Token
• 输出Token: 约 ¥0.002/千Token
• 平均成本: 每次文案生成约 ¥0.01-0.05

建议: 新用户可以先申请免费试用额度进行测试。

备用方案

如果DeepSeek服务不可用，系统会自动切换到阿里云DashScope作为备用方案。确保同时配置好DashScope API密钥。

技术支持

• 官方文档: DeepSeek API文档
• 社区支持: DeepSeek开发者社区
• 客服联系: 平台内嵌的在线客服

更新日志

v1.0.0 (2025-01-08)

• 首次集成DeepSeek大模型
• 实现创意文案生成功能
• 添加故障转移机制
• 完善配置文档

---

注意: 请妥善保管您的API密钥，不要将其提交到版本控制系统。