电商商品描述 AI 批量生成：GPT-4o API 接入与 prompt 模板实践

作为一名在某宝经营女装店铺三年的卖家，我每天要为几十款新上架的商品撰写描述文案。过去这项工作占用了我大量的时间——既要突出产品卖点，又要考虑搜索引擎优化（SEO），还要让文字读起来自然不生硬。直到我学会了使用 HolySheep AI 的 GPT-4o API 来批量生成商品描述，终于从繁琐的文案工作中解放出来。

今天这篇文章，我将用最通俗易懂的方式，手把手教没有任何编程基础的你，如何在 30 分钟内学会用 AI 批量生成电商店铺的商品描述。整个过程不需要写一行代码，只需要跟着步骤复制粘贴即可完成。

一、为什么选择 HolySheep AI？

在开始之前，先简单说一下为什么我推荐使用 HolySheep AI 作为你的 API 服务商。相比直接使用官方 API，HolySheep 有以下几个明显优势：

• 成本优势：官方 GPT-4o 的价格较高，而 HolySheep 的汇率相当于 ¥1=$1，比官方 ¥7.3=$1 节省超过 85% 的成本。
• 国内直连：服务器部署在国内，响应速度快，延迟通常在 50ms 以内，调用体验流畅。
• 充值便捷：支持微信、支付宝直接充值，没有复杂的支付障碍。
• 新用户福利：注册即送免费额度，可以先体验再决定是否付费。

二、准备工作：获取你的 API Key

使用任何 AI API 的第一步，都是获取一个"身份凭证"，也就是 API Key。以下是获取步骤：

1. 打开浏览器，访问 HolySheep 官网并注册账号。
2. 注册完成后，登录进入控制台。
3. 在左侧菜单中找到「API Keys」选项并点击。
4. 点击「创建新密钥」按钮，系统会生成一串字符，这就是你的 API Key。

【截图提示】图1：在控制台中点击「API Keys」选项

【截图提示】图2：点击创建按钮后弹出密钥名称输入框

【截图提示】图3：复制生成的 API Key，注意保护不要泄露

请将你的 API Key 复制并保存好，后面代码中需要用到。为了安全起见，页面刷新后密钥将不再完整显示，所以一定要妥善保管。

三、安装 Python 环境

虽然我说不需要写代码，但运行脚本还是需要 Python 环境的。不过别担心，安装过程很简单：

1. 打开 Python 官网 https://www.python.org/
2. 点击「Downloads」按钮，选择适合你电脑系统的安装包（Windows 用户选择 Windows installer，Mac 用户选择 macOS）
3. 下载完成后运行安装程序，注意勾选「Add Python to PATH」选项
4. 点击「Install Now」等待安装完成

【截图提示】图4：安装界面，务必勾选「Add Python to PATH」

安装完成后，按下键盘上的「Win+R」键（Mac 用户按 Command+Space 打开搜索），输入「cmd」回车打开命令提示符窗口。输入以下命令检查 Python 是否安装成功：

python --version

如果显示类似「Python 3.11.5」这样的版本号，说明安装成功。

四、安装调用库

接下来需要安装一个帮助我们调用 API 的工具库。还是在命令提示符窗口中输入：

pip install openai

等待安装完成后，你会看到「Successfully installed openai-xxx」这样的提示。

【截图提示】图5：pip 安装成功的终端输出

五、编写第一个调用脚本

现在我们开始写调用代码。打开电脑自带的记事本（或者下载安装「VS Code」编辑器），新建一个文件，命名为 generate_desc.py。

在文件中输入以下代码：

import openai

配置 API 密钥和接口地址
client = openai.OpenAI(
    api_key="YOUR_HOLYSHEEP_API_KEY",  # 替换成你的真实 API Key
    base_url="https://api.holysheep.ai/v1"
)

定义一个生成商品描述的函数
def generate_product_description(product_name, product_features):
    """
    生成商品描述
    参数:
        product_name: 商品名称
        product_features: 商品特点列表
    返回:
        生成的商品描述文案
    """
    # 构造 prompt
    prompt = f"""你是一位经验丰富的电商文案撰写师。请为以下商品撰写一段吸引人的详情页描述。

商品名称：{product_name}
商品特点：{', '.join(product_features)}

要求：
1. 开头要有吸引力，能够引发买家兴趣
2. 突出商品的核心卖点
3. 语言生动自然，像真人写作
4. 适当融入 SEO 关键词
5. 字数控制在 150-200 字
6. 结尾要有引导购买的语句
"""
    
    # 调用 API
    response = client.chat.completions.create(
        model="gpt-4o",
        messages=[
            {"role": "system", "content": "你是一位专业的电商文案师，擅长撰写吸引人的商品描述。"},
            {"role": "user", "content": prompt}
        ],
        temperature=0.7,
        max_tokens=500
    )
    
    # 返回生成的文案
    return response.choices[0].message.content

测试调用
if __name__ == "__main__":
    # 示例商品信息
    product_name = "韩版宽松显瘦针织开衫"
    product_features = ["柔软亲肤面料", "韩版oversize版型", "多种莫兰迪色系", "单排扣设计", "可搭配连衣裙或牛仔裤"]
    
    # 生成描述
    description = generate_product_description(product_name, product_features)
    
    print("生成的商品描述：")
    print("=" * 50)
    print(description)

保存文件后，回到命令提示符窗口，进入文件所在目录（使用 cd 命令），然后运行：

python generate_desc.py

【截图提示】图6：运行脚本后的终端输出

如果一切正常，你将看到 AI 为你生成的商品描述文案！

六、进阶：批量生成商品描述

单个生成学会了，接下来我们学习如何批量生成。假设你有一个 Excel 表格，里面有 50 个商品的信息，需要一次性生成所有描述。

首先，你需要在 Excel 中整理好商品数据，格式如下：

商品名称	商品特点
韩版宽松显瘦针织开衫	柔软亲肤面料|韩版oversize版型|多种莫兰迪色系
高腰显瘦阔腿牛仔裤	高腰设计|直筒版型|水洗牛仔面料|百搭款式
法式复古波点连衣裙	收腰设计|雪纺面料|波点元素|可盐可甜

注意：商品特点用「|」符号分隔。

新建一个文件 batch_generate.py，输入以下代码：

import openai
import pandas as pd
import time

配置 API
client = openai.OpenAI(
    api_key="YOUR_HOLYSHEEP_API_KEY",  # 替换成你的真实 API Key
    base_url="https://api.holysheep.ai/v1"
)

def generate_description(product_name, features_list, retry=3):
    """
    生成单个商品描述，带重试机制
    """
    prompt = f"""你是一位专业的电商文案师。请为以下女装商品撰写详情页描述。

商品名称：{product_name}
商品特点：{', '.join(features_list)}

要求：
1. 开头有吸引力，引发买家购买欲望
2. 突出商品核心卖点
3. 语言生动自然，避免生硬广告感
4. 适当融入 SEO 关键词
5. 字数控制在 150-200 字
6. 结尾引导下单
"""
    
    for attempt in range(retry):
        try:
            response = client.chat.completions.create(
                model="gpt-4o",
                messages=[
                    {"role": "system", "content": "你是一位专业电商文案师，擅长女装品类的内容创作。"},
                    {"role": "user", "content": prompt}
                ],
                temperature=0.7,
                max_tokens=500
            )
            return response.choices[0].message.content
        except Exception as e:
            if attempt < retry - 1:
                wait_time = 2 ** attempt
                print(f"请求失败，{wait_time}秒后重试...")
                time.sleep(wait_time)
            else:
                return f"生成失败: {str(e)}"

def batch_generate_from_excel(excel_path, output_path):
    """
    从 Excel 批量读取商品信息并生成描述
    """
    # 读取 Excel 文件
    df = pd.read_excel(excel_path)
    
    # 存储生成的描述
    descriptions = []
    
    print(f"开始批量生成，共 {len(df)} 个商品...")
    
    for index, row in df.iterrows():
        product_name = row['商品名称']
        # 将特点字符串转换为列表
        features = str(row['商品特点']).split('|')
        
        print(f"正在处理第 {index + 1}/{len(df)} 个: {product_name}")
        
        # 生成描述
        description = generate_description(product_name, features)
        descriptions.append(description)
        
        # 添加延时，避免请求过快
        time.sleep(1)
    
    # 将结果添加到 DataFrame
    df['生成的描述'] = descriptions
    
    # 保存到新的 Excel 文件
    df.to_excel(output_path, index=False)
    print(f"批量生成完成！结果已保存到 {output_path}")

运行批量生成
if __name__ == "__main__":
    batch_generate_from_excel('products.xlsx', 'products_with_descriptions.xlsx')

准备好 Excel 文件后，运行：

python batch_generate.py

程序会依次处理每个商品，自动将结果保存到新的 Excel 文件中。整个过程你只需要准备好商品信息表格，剩下的交给 AI 完成。

【截图提示】图7：批量生成过程中的终端输出

【截图提示】图8：生成完毕后的 Excel 结果文件

七、Prompt 模板优化技巧

要让 AI 生成更符合你店铺风格的描述，Prompt（提示词）的设计非常重要。以下是几个实用的优化技巧：

1. 明确目标受众

# 在 prompt 中加入受众描述
prompt = """请为以下商品撰写详情页描述。
目标受众：25-35岁都市白领女性，偏好简约气质风格
商品名称：xxx
商品特点：xxx
..."""

2. 固定文案结构

如果你希望每件商品的描述都有固定的结构，可以在 prompt 中明确要求：

prompt = """请按以下结构撰写商品描述：
1. 开场钩子（一句话吸引注意力）
2. 产品介绍（材质、款式、适用场景）
3. 卖点提炼（3-5个核心优势）
4. 搭配建议
5. 购买引导
商品信息：xxx
..."""

3. 加入店铺风格关键词

为了让文案风格统一，可以固定一些你店铺常用的词汇：

prompt = """请使用以下风格词汇撰写描述：
【必用词汇】温柔、高级感、精致、质感、氛围感
【禁用词汇】便宜、划算、甩卖、正品保证（太生硬）
商品：xxx
..."""

八、成本估算与优化建议

使用 API 调用会产生费用，了解成本构成能帮助你更好地控制预算。GPT-4o 的费用主要和生成的 Token 数量有关。

以 HolySheep AI 为例，GPT-4o 的 output 价格是 $8/百万 Token。假设每个商品描述平均生成 200 字（约 150 个 Token），生成 1000 件商品的描述：

• Token 消耗：1000 × 150 = 150,000 Token = 0.15 MTok
• 费用：0.15 × $8 = $1.2（约 ¥8.76，按 ¥7.3=$1 汇率）

可以看到，使用 HolySheep 的汇率优势，批量生成 1000 条商品描述的成本不到 10 元人民币，性价比极高。

节省成本的建议：

• 合理设置 max_tokens 参数，避免生成过长内容
• 批量处理时适当添加延时，避开高峰期
• 利用好 HolySheep 的新用户免费额度

常见报错排查

在调用 API 的过程中，你可能会遇到一些错误。以下是三个最常见的问题及解决方法：

问题一：API Key 无效或为空

Error: Incorrect API key provided: YOUR_HOLYSHEEP_API_KEY

原因：API Key 未正确替换或格式有误。

解决方法：

• 确认你复制的是完整的 API Key，没有遗漏前后字符
• 检查是否有空格或其他不可见字符
• 回到 HolySheep 控制台 重新获取密钥

问题二：请求超时或连接失败

Error: Connection timeout or HTTPSConnectionPool(host='api.holysheep.ai', port=443)

原因：网络连接问题，或者 base_url 配置错误。

解决方法：

• 确认 base_url 为 https://api.holysheep.ai/v1（注意 https 和结尾的 /v1）
• 检查网络是否稳定，可以尝试刷新或切换网络
• 确认防火墙或代理设置没有拦截请求

问题三：余额不足

Error: You exceeded your current quota, please check your plan and billing details

原因：账户余额已用完。

解决方法：

• 登录 HolySheep AI 控制台查看账户余额
• 使用微信或支付宝进行充值
• 如果是新用户，确认是否还有未使用的免费额度

九、总结

通过今天的教程，你应该已经掌握了如何使用 HolySheep AI 的 GPT-4o API 来批量生成电商商品描述。整个流程可以概括为：

1. 注册账号获取 API Key → 访问 HolySheep 完成认证
2. 安装 Python 环境 → 几分钟即可完成
3. 安装 openai 库 → 一条命令搞定
4. 编写并运行脚本 → 复制粘贴模板代码
5. 批量生成 → 准备好 Excel 数据，自动处理

现在，你不需要再为每件商品绞尽脑汁想文案了。把商品信息整理好交给 AI，批量生成高质量描述，效率提升何止 10 倍！

赶紧去试试吧，相信你会有惊喜的发现。

👉 <