HiAPI
博客

使用指南

Claude Opus 4.8 用于电子商务:通过 hiapi API 进行文案写作、视觉质检与客户支持

带有视觉标签但实际为纯文本:claude-opus-4-8 对在线商店究竟有什么用

2026年11月3日
Claude Opus 4.8 用于电子商务:通过 hiapi API 进行文案写作、视觉质检与客户支持

claude-opus-4-8 在 hiapi 上带有 LLM, Reasoning, Vision, Streaming, Tool Calls 标签。任何地方都没有 Image Generation 标签——它不生成图片。因此,当需求要求“产品图片”时,诚实的回答是:模型选错了。它在在线商店中的真正长处是读取图片和撰写文本:按照你自己的质检规则评判产品照片、撰写产品文案,以及回答客服问题。以下是针对 hiapi API 的三次真实调用,包含每次的真实输出和真实费用。

为什么电商文本和视觉工作要选 claude-opus-4-8

claude-opus-4-8 在 hiapi 上可通过两条路径使用,它们指向同一个模型,但定价不同:

  • claude-opus-4-8(默认)——更便宜的路径。
  • claude-opus-4-8-aws——经由 AWS 基础设施路由,输入和输出 token 的费用都恰好是默认路径的 2.5 倍。

对于电商文案、客服回复和照片质检来说,这些工作除了路由之外,不需要 AWS 路径提供的任何额外能力,因此默认路径才是应当选择的。最新的完整数字见 hiapi 定价页——在确定路线之前请先查看,因为按 token 计价正是那种会随时间变化的数字。

在开始示例之前,有一点值得提醒:默认路径自己的模型卡将其描述为文本生成、流式输出和工具调用——完全没提图像输入。claude-opus-4-8-aws 的模型卡则明确写着:“支持文本和图像输入。”在下面的测试中,默认路径无论如何都正确处理了图像输入请求。教训不是“相信视觉标签而不是模型卡”,也不是“相信模型卡而不是标签”——而是当模型卡和能力标签不一致时,唯一可靠的答案就是发送一个真实请求并读取真实响应,这正是本文其余部分所做的。

用例 1:通过 Vision 进行产品照片质检

思路是:与其让人工扫描每一张新上架的照片,不如把一套简短规则和一张照片交给模型,让它在商品上架前标记出任何不合格的地方。

这里的测试照片故意选了一个真正糟糕的案例:深色背景上约十件互不相关的配饰(钱包、太阳镜、领结、笔、笔记本、手机、手表、耳机)的平铺摆拍,而不是干净的单品拍摄。目的是看模型是否真的能发现这一点,而不是敷衍盖章通过。

curl https://api.hiapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "messages": [
      {
        "role": "system",
        "content": "You are a marketplace photo QA reviewer. Check the product photo against these four rules and give a PASS or FLAG verdict for each, with a one-sentence reason: (1) product is centered and fully visible, (2) background is clean and neutral, (3) no visible damage or defects, (4) lighting is even enough to judge true color. End with one overall verdict."
      },
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "Review this listing photo."},
          {"type": "image_url", "image_url": {"url": "https://picsum.photos/id/26/800/600"}}
        ]
      }
    ]
  }'

实际响应,未编辑:

规则 1——居中且完整可见:标记。 这不是单品拍摄。这是一张平铺摆拍,大约十件物品(拉链钱包、太阳镜、领结、笔、卡包、笔记本、名片夹、手机、手表、眼镜、耳机)散布在网格上,四周留有大量空白边距。没有物品处于中心,任何使用这张图的商品列表都不会有清晰的主体。如果实际在售的是其中某一件产品,它需要单独裁剪。

规则 2——干净/中性背景:通过。 无缝深灰色表面,整个画面均匀一致,没有竞争性的道具或图案。四个角落的色调保持一致。

规则 3——无可见损坏或缺陷:通过(有限)。 没有任何东西看起来像有裂纹、刮痕或撕裂,画面中也完全没有包装。值得注意的是,该评估受分辨率和比例限制——皮革制品上的小划痕或缝线瑕疵在这里无法检测到,因此如果损坏检查对该 SKU 很重要,请使用更近的拍摄。

规则 4——光照能显示真实颜色:标记。 曝光偏暗,阴影衰减严重,尤其是左下角和底边。黑色没有呈现为黑色——钱包、名片夹和手机看起来略微偏暖/橄榄色,笔记本上的“绿色”边缘也含糊不清。买家无法据此可靠地判断颜色。更亮、更均匀、更高调的光照可以解决这个问题。

总体:标记——不要按原样发布。 该画面是多物品生活方式构图,不是合规的单品照片,而且曝光不足,无法准确呈现颜色。请在同一中性背景下以均匀光照重新拍摄一件居中的产品,或裁剪出单件物品并重新曝光。

它发现了真正的问题(多件产品,没有清晰主体),而不是仅仅描述图片;并且它在规则 3 上正确地保留了余地,而不是从低分辨率图像中过度断言确定性——这是大多数评分标准检查脚本不会自己想到添加的注意事项。

此次调用使用了 769 个 token(143 个提示 + 626 个补全),在默认路径上合计约 $0.0075。

用例 2:产品文案写作

同一个模型,这次是纯文本——把规格表变成商品列表。

curl https://api.hiapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "messages": [
      {
        "role": "system",
        "content": "You are an e-commerce copywriter. Given a product'"'"'s specs, write: a title (max 70 characters), 3 bullet feature points, and a 2-3 sentence description. No superlatives, no exclamation marks, stay factual."
      },
      {
        "role": "user",
        "content": "Product: zip-around wallet. Material: full-grain leather, hand-stitched edges. Capacity: 6 card slots + cash compartment. Closure: zip-around. Fit: slim enough for a front pocket."
      }
    ]
  }'

实际响应,未编辑:

标题: 纤薄拉链全粒面皮革钱包——6 卡位 + 现金

特点:

  • 全粒面皮革配手工缝制边缘,经得起日常使用
  • 低轮廓框架,可容纳 6 张卡及折叠现金
  • 拉链闭合确保物品安全;尺寸适合放入前袋

描述: 这款拉链钱包可容纳六张卡和现金,结构纤薄,足以放入你的前袋。全粒面皮革和手工缝制边缘意味着它会随使用而老化,并在多年日常携带中保持完好。

没有“高级”,没有“必备”,没有感叹号——它遵循了“不用最高级词汇”的指令,而这通常是文案提示词容易失败的地方。总计 364 个 token,约 $0.0026。

用例 3:客户支持回复

把实际退货政策和真实客户留言交给它,它就能起草一封人工稍作编辑(或无需编辑)即可发送的回复。

curl https://api.hiapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "messages": [
      {
        "role": "system",
        "content": "You are a customer support agent for an online wallet store. Store policy: 30-day return window from delivery; if the item arrived damaged or wrong, the store covers return shipping and offers a replacement or exchange. Reply in under 150 words, be empathetic but concise, and end with a clear next step."
      },
      {
        "role": "user",
        "content": "I ordered a wallet 3 weeks ago and it arrived with a scratch on the front panel. Can I still return it, and do I have to pay for shipping?"
      }
    ]
  }'

实际响应,未编辑:

很抱歉——全新钱包上有划痕确实令人失望,你对我们有更高的期望是合理的。

两个问题的答案都对你有利:

  • 退货窗口: 你已经收到 3 周,仍在我们的 30 天政策范围内。
  • 运费: 到货时有划痕属于损坏,因此我们承担退货运费。你寄回无需支付任何费用。

接下来做什么:请发送你的订单号和划痕前面板的照片。我们会开具预付标签并启动换货流程。

如果你不想直接换货,而想换另一款钱包,请告诉我们,我们会处理差价。

它正确应用了两条政策规则(窗口 + 损坏运费),而不是只选一条,并且保持在 150 词上限以内。385 个 token,约 $0.0028。

费用说明

以上三次调用都运行在默认 claude-opus-4-8 路径上,总计 1,518 个 token,合计约 $0.013——没有图像生成,没有按图收费,只有模型自身 定价页 上的 token 费用。该模型的视觉输入像任何其他输入一样按 token 计费,而不是按图收取固定费用,因此更大或更复杂的照片(更多物品、更多需要描述的细节)会比上面的平铺测试花费更多。如果你要在商品目录规模上运行此流程,请按 token 而非按图做预算,并在确定月度用量之前查看当前费率——它们正是那种会变化的数字。

常见问题

claude-opus-4-8 能生成产品图片吗? 不能。它带有 Reasoning 和 Vision 标签,而不是 Image Generation,它返回的每个响应都是文本。如果实际工作是制作新的产品摄影或生活方式照片,那需要图像模型,而不是这个。

claude-opus-4-8 在 hiapi 上真的支持图像输入吗? 是的——已通过在上面的请求中发送真实图片并在默认路径上获得基于图像的响应而确认。claude-opus-4-8-aws 路径自己的模型卡明确记录了图像输入;默认路径的模型卡没有提到这一点,在假定模型卡就是全部事实之前,值得了解。

我应该使用哪条路径,默认还是 AWS? 对于像上面三个这样的文本和视觉电商工作负载,使用默认 claude-opus-4-8 路径——它是同一个模型,每 token 价格是 claude-opus-4-8-aws 的 1/2.5。

质检一张产品照片要多少钱? 上面的平铺测试约 $0.0075(769 个 token)。更简单的单品照片配更短的规则集会更便宜;更密集的图像或更长的评分标准会更贵,因为视觉输入按 token 计费。

开始使用

自己尝试:一个 hiapi API 密钥,默认路径当前规格见 claude-opus-4-8 模型页,或者如果你特别需要那种路由,见 claude-opus-4-8-aws。如果你要在 hiapi 上构建更广泛的电商内容工作流,kimi-k3 电商文章 用另一个模型覆盖了相同的文案写作和支持场景,在为生产选择模型之前值得与上面的结果进行比较。

立即开始构建持久 AI 产物

获取 API 密钥,通过一个基于任务(task)的 API 调用图像、视频和音频模型。

阅读 API 文档