HiAPI
ブログ

使用ガイド

電子商取引のためのClaude Opus 4.8:hiapi APIによるコピーライティング、ビジュアル品質チェック、カスタマーサポート

ビジョンタグがあるのに実態は純粋なテキスト:claude-opus-4-8はオンラインストアで何の役に立つのか

Sep 21, 2026
電子商取引のためのClaude Opus 4.8:hiapi APIによるコピーライティング、ビジュアル品質チェック、カスタマーサポート

claude-opus-4-8はhiapi上でLLM, Reasoning, Vision, Streaming, Tool Callsタグを持っています。どこにもImage Generationタグはありません——画像を生成しないのです。したがって、「商品画像」が求められる場面での正直な答えは「モデルの選択を間違えている」です。オンラインストアにおける本当の強みは、画像を読み取りテキストを書くことです。自社の品質チェックルールに従って商品写真を評価し、商品コピーを書き、カスタマーサポートの質問に答えることです。以下はhiapi APIに対する3回の実際の呼び出しで、毎回の実際の出力と実際のコストを含みます。

なぜECのテキストとビジュアル業務にclaude-opus-4-8を選ぶのか

claude-opus-4-8はhiapi上で2つの経路から利用でき、それらは同じモデルを指しますが価格が異なります:

  • claude-opus-4-8(デフォルト)——より安価な経路。
  • claude-opus-4-8-aws——AWSインフラ経由でルーティングされ、入力トークンと出力トークンの費用がどちらもデフォルト経路のちょうど2.5倍。

ECのコピー、サポート返信、写真の品質チェックという業務では、これらはルーティング以外にAWS経路ならではの追加能力を必要としないため、デフォルト経路を選ぶべきです。最新の完全な数値はhiapi料金ページを参照してください——路線を決める前に必ず確認してください。トークン課金は時間とともに変わる類の数字だからです。

例を始める前に一つ注意しておきたいことがあります。デフォルト経路自身のモデルカードは、テキスト生成、ストリーミング出力、ツール呼び出しと説明しており、画像入力には全く触れていません。claude-opus-4-8-awsのモデルカードには明確に「テキストと画像入力に対応」と書かれています。以下のテストでは、デフォルト経路がそれでも画像入力リクエストを正しく処理しました。教訓は「ビジョンタグよりモデルカードを信じる」でも「モデルカードよりタグを信じる」でもありません——モデルカードと能力タグが食い違うとき、唯一信頼できる答えは実際のリクエストを送って実際の応答を読むことです。この記事の残りはまさにそれをしています。

ユースケース1:Visionによる商品写真の品質チェック

狙いはこうです。新しく掲載される写真をすべて人間が目視でスキャンする代わりに、短いルールセットと写真1枚をモデルに渡し、商品掲載前に不合格箇所をフラグさせます。

ここでのテスト写真はあえて本当にひどいケースを選びました。暗い背景に約10点の無関係なアクセサリー(財布、サングラス、蝶ネクタイ、ペン、ノート、スマートフォン、腕時計、ヘッドホン)を並べたフラットレイで、クリーンな単品撮影ではありません。目的は、モデルがおざなりに合格を押し付けるのではなく、本当にこの問題を発見できるかを見ることです。

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——中央に配置され完全に見える:フラグ。 これは単品撮影ではありません。約10点のアイテム(ジップ財布、サングラス、蝶ネクタイ、ペン、カードケース、ノート、名刺入れ、スマートフォン、腕時計、メガネ、ヘッドホン)がグリッド上に散らばり、周囲に大量の空白マージンが残されたフラットレイです。どのアイテムも中心になく、この画像を使うどの商品リスティングにも明確な主体がありません。実際に販売されているのがそのうちの1点なら、個別にトリミングする必要があります。

ルール2——クリーンで中性的な背景:合格。 継ぎ目のない濃いグレーの表面が画面全体で均一に一致し、競合する小道具やパターンはありません。四隅の色調も一貫しています。

ルール3——目に見える損傷や欠陥なし:合格(限定的)。 ひび割れ、引っかき傷、破れのように見えるものはなく、画面内に包装も一切ありません。特筆すべきは、この評価が解像度とスケールに制約されている点です——革製品の小さな傷や縫い目の不良はここでは検出できません。そのため、損傷チェックがそのSKUにとって重要なら、より近接した撮影を使用してください。

ルール4——実際の色を判断できる明るさ:フラグ。 露出が暗く、特に左下と下端で影の減衰が深刻です。黒が黒として表現されていません——財布、名刺入れ、スマートフォンはわずかに暖色/オリーブ色に見え、ノートの「緑」の縁も曖昧です。買い手はこれで色を信頼して判断できません。より明るく均一でハイキーな照明ならこれを解決できます。

総合:フラグ——このままでは公開しないでください。 この画面は複数アイテムのライフスタイル構図であり、基準を満たす単品写真ではなく、露出不足で色を正確に示せません。同じ中性背景で均一な照明のもと、中央に1点の商品を配置して撮り直すか、単品をトリミングして再露出してください。

単に画像を描写するのではなく、本当の問題(複数商品で明確な主体がない)を発見しました。そしてルール3では低解像度画像から過度に断定せず、正しく留保を残しました——これはほとんどの採点基準チェックスクリプトが自分で思いつかない注意点です。

この呼び出しは769トークン(プロンプト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枚と折りたたんだ現金を収納
  • ファスナー閉じで中身を安全に保ち、前ポケットに入るサイズ

説明: このラウンドジップ財布はカード6枚と現金を収納でき、前ポケットに入るほど薄い構造です。フルグレインレザーと手縫いの縁は、使うほどに味が出て、長年の日常携帯でも損なわれないことを意味します。

「高級」も「必須」も感嘆符もなし——「最上級語を使わない」という指示に従っており、これはコピーのプロンプトがよく失敗する箇所です。合計364トークン、約$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?"
      }
    ]
  }'

実際の応答、未編集:

大変申し訳ございません——新品の財布に傷があったのは確かに残念なことで、私たちにもっと期待されるのは当然です。

2つのご質問への答えはどちらもお客様に有利です:

  • 返品期間: 受け取りから3週間が経過していますが、当店の30日ポリシーの範囲内です。
  • 送料: 到着時の傷は損傷にあたるため、返送料は当店が負担します。返送にかかる費用は一切ありません。

次にすること:ご注文番号と、傷のある前面パネルの写真をお送りください。前払いラベルを発行し、交換手続きを開始します。

そのまま交換ではなく別の財布に替えたい場合はお知らせください。差額を処理いたします。

2つのポリシールール(期間 + 損傷時の送料)を片方だけ選ばず正しく適用し、150語の上限内に収めました。385トークン、約$0.0028。

コストの説明

上記3回の呼び出しはすべてデフォルトのclaude-opus-4-8経路で実行され、合計1,518トークン、合わせて約$0.013——画像生成なし、画像ごとの課金なし、モデル自身の料金ページにあるトークン費用のみです。このモデルのビジュアル入力は他の入力と同じくトークンで課金され、画像ごとの固定料金ではありません。そのため、より大きく複雑な写真(アイテムが多く、描写すべき詳細が多い)は上記のフラットレイテストより高くつきます。このフローを商品カタログ規模で実行するなら、画像ごとではなくトークン単位で予算を組み、月間使用量を確定する前に現在の料金を確認してください——それらは変わる類の数字です。

よくある質問

claude-opus-4-8は商品画像を生成できますか? いいえ。ReasoningとVisionのタグを持ち、Image Generationではありません。返すすべての応答はテキストです。実際の業務が新しい商品写真やライフスタイル写真の制作なら、画像モデルが必要で、これではありません。

claude-opus-4-8はhiapi上で本当に画像入力に対応していますか? はい——上記のリクエストで実際の画像を送り、デフォルト経路で画像に基づく応答を得て確認済みです。claude-opus-4-8-aws経路自身のモデルカードは画像入力を明記しています。デフォルト経路のモデルカードはこれに触れておらず、モデルカードがすべての事実だと仮定する前に知っておく価値があります。

どちらの経路を使うべきですか、デフォルトかAWSか? 上記3つのようなテキストとビジュアルのECワークロードには、デフォルトのclaude-opus-4-8経路を使ってください——同じモデルで、トークンあたりの価格はclaude-opus-4-8-awsの1/2.5です。

商品写真1枚の品質チェックにいくらかかりますか? 上記のフラットレイテストは約$0.0075(769トークン)です。よりシンプルな単品写真と短いルールセットなら安くなり、より密な画像や長い採点基準なら高くなります。ビジュアル入力はトークンで課金されるからです。

はじめに

自分で試すには:hiapi APIキー、デフォルト経路の現在の仕様はclaude-opus-4-8モデルページ、あるいはそのルーティングが特に必要な場合はclaude-opus-4-8-awsを参照してください。hiapi上でより広範なECコンテンツワークフローを構築するなら、kimi-k3 EC記事が別のモデルで同じコピーライティングとサポートのシナリオを扱っており、本番用モデルを選ぶ前に上記の結果と比較する価値があります。

永続的なAIアーティファクトで開発を始める

APIキーを取得して、タスクベースの1つのAPIで画像・動画・音声モデルを呼び出せます。

APIドキュメントを読む