Claude Opus 4.8 para e-commerce: redação de textos, controle de qualidade visual e suporte ao cliente via API hiapi

O claude-opus-4-8 no hiapi traz as etiquetas LLM, Reasoning, Vision, Streaming, Tool Calls. Não há etiqueta Image Generation em lugar nenhum — ele não gera imagens. Portanto, quando a demanda pede "imagens de produto", a resposta honesta é: o modelo errado foi escolhido. A verdadeira força dele em uma loja online é ler imagens e escrever textos: avaliar fotos de produto segundo suas próprias regras de controle de qualidade, redigir textos de produto e responder a perguntas de atendimento ao cliente. A seguir, três chamadas reais à API hiapi, com a saída real e o custo real de cada uma.

Por que escolher claude-opus-4-8 para texto e visão em e-commerce

O claude-opus-4-8 está disponível no hiapi por dois caminhos, que apontam para o mesmo modelo mas têm preços diferentes:

• claude-opus-4-8 (padrão) — o caminho mais barato.
• claude-opus-4-8-aws — roteado pela infraestrutura da AWS, com custo de tokens de entrada e de saída exatamente 2,5 vezes o do caminho padrão.

Para textos de e-commerce, respostas de atendimento e controle de qualidade de fotos, esse trabalho não exige nada além do roteamento que o caminho AWS oferece, então o caminho padrão é o que deve ser escolhido. Os números completos e atualizados estão na página de preços do hiapi — consulte-a antes de definir a rota, pois preços por token são justamente o tipo de número que muda com o tempo.

Antes de começar os exemplos, vale um aviso: o próprio model card do caminho padrão o descreve como geração de texto, saída em streaming e chamadas de ferramentas — sem mencionar entrada de imagem. O model card do claude-opus-4-8-aws diz explicitamente: "suporta entradas de texto e imagem". Nos testes abaixo, o caminho padrão processou corretamente as solicitações de entrada de imagem de qualquer forma. A lição não é "confie na etiqueta de visão em vez do model card", nem "confie no model card em vez da etiqueta" — mas sim que, quando o model card e as etiquetas de capacidade divergem, a única resposta confiável é enviar uma solicitação real e ler a resposta real, que é exatamente o que o resto deste artigo faz.

Caso de uso 1: controle de qualidade de fotos de produto via Vision

A ideia é: em vez de uma pessoa escanear cada foto recém-cadastrada, entregar um conjunto curto de regras e uma foto ao modelo, para que ele sinalize qualquer problema antes de o produto ir ao ar.

A foto de teste aqui escolheu de propósito um caso realmente ruim: uma composição flat lay de cerca de dez acessórios não relacionados (carteira, óculos de sol, gravata borboleta, caneta, caderno, celular, relógio, fones de ouvido) sobre fundo escuro, em vez de uma foto limpa de um único item. O objetivo era ver se o modelo realmente detectaria isso, em vez de carimbar aprovação sem critério.

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"}}
        ]
      }
    ]
  }'

Resposta real, sem edição:

Regra 1 — centralizado e completamente visível: SINALIZADO. Não é uma foto de um único item. É uma composição flat lay com cerca de dez itens (carteira com zíper, óculos de sol, gravata borboleta, caneta, porta-cartões, caderno, porta-cartão de visita, celular, relógio, óculos, fones de ouvido) espalhados sobre uma grade, com bastante margem vazia ao redor. Nenhum item está no centro, e qualquer listagem que use esta imagem não terá um sujeito claro. Se o produto realmente à venda é um desses itens, ele precisa de um recorte separado.

Regra 2 — fundo limpo/neutro: APROVADO. Superfície cinza-escuro sem emendas, uniforme em todo o quadro, sem adereços ou padrões concorrentes. O tom dos quatro cantos é consistente.

Regra 3 — sem danos ou defeitos visíveis: APROVADO (com ressalvas). Nada parece rachado, arranhado ou rasgado, e não há embalagem alguma no quadro. Vale notar que essa avaliação é limitada pela resolução e pela proporção — arranhões pequenos ou falhas de costura em produtos de couro não são detectáveis aqui, então se a verificação de danos for importante para esse SKU, use uma foto mais próxima.

Regra 4 — iluminação permite mostrar cores reais: SINALIZADO. A exposição está escura, com queda forte de sombra, especialmente no canto inferior esquerdo e na borda inferior. O preto não aparece como preto — a carteira, o porta-cartões e o celular parecem levemente mais quentes/oliva, e a borda "verde" no caderno também é ambígua. O comprador não consegue avaliar a cor com confiança a partir disso. Uma iluminação mais clara, mais uniforme e mais high-key resolveria o problema.

Geral: SINALIZADO — não publique como está. O quadro é uma composição lifestyle com vários itens, não uma foto de produto único em conformidade, e está subexposto demais para apresentar cores com precisão. Refotografe um produto centralizado no mesmo fundo neutro com iluminação uniforme, ou recorte um único item e reexponha.

Ele encontrou os problemas reais (vários produtos, sem sujeito claro) em vez de apenas descrever a imagem; e manteve corretamente a ressalva na regra 3, em vez de afirmar certeza excessiva a partir de uma imagem de baixa resolução — uma ressalva que a maioria dos scripts de verificação de rubricas não pensaria em adicionar sozinha.

Essa chamada usou 769 tokens (143 de prompt + 626 de completion), totalizando cerca de $0,0075 no caminho padrão.

Caso de uso 2: redação de textos de produto

O mesmo modelo, agora só texto — transformar uma ficha técnica em uma listagem de produto.

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."
      }
    ]
  }'

Resposta real, sem edição:

Título: Carteira slim com zíper em couro full-grain — 6 slots + dinheiro

Características:

• Couro full-grain com bordas costuradas à mão, resistente ao uso diário
• Estrutura de baixo perfil que comporta 6 cartões e dinheiro dobrado
• Fechamento com zíper mantém os itens seguros; tamanho que cabe no bolso frontal

Descrição: Esta carteira com zíper comporta seis cartões e dinheiro em uma estrutura fina o bastante para caber no bolso frontal. O couro full-grain e as bordas costuradas à mão significam que ela vai envelhecer com o uso e se manter íntegra ao longo de anos de transporte diário.

Sem "premium", sem "indispensável", sem pontos de exclamação — ele seguiu a instrução de "sem superlativos", que é justamente onde prompts de redação costumam falhar. No total, 364 tokens, cerca de $0,0026.

Caso de uso 3: resposta de suporte ao cliente

Entregue a política real de devolução e uma mensagem real de cliente, e ele redige uma resposta que uma pessoa só precisa editar levemente (ou nada) para enviar.

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?"
      }
    ]
  }'

Resposta real, sem edição:

Sinto muito — um arranhão em uma carteira nova é realmente decepcionante, e você tem razão em esperar mais de nós.

As respostas para as duas perguntas são a seu favor:

• Prazo de devolução: você recebeu há 3 semanas, o que ainda está dentro da nossa política de 30 dias.
• Frete: um arranhão na chegada conta como dano, então nós cobrimos o frete de devolução. Você não precisa pagar nada para enviá-la de volta.

Próximo passo: envie o número do pedido e uma foto do painel frontal arranhado. Emitiremos uma etiqueta pré-paga e iniciaremos a troca.

Se em vez da troca direta você preferir outra carteira, é só avisar, e cuidamos da diferença de preço.

Ele aplicou corretamente as duas regras da política (prazo + frete por dano), em vez de escolher só uma, e ficou dentro do limite de 150 palavras. 385 tokens, cerca de $0,0028.

Nota sobre custos

As três chamadas acima rodaram no caminho padrão claude-opus-4-8, totalizando 1.518 tokens, cerca de $0,013 no total — sem geração de imagem, sem cobrança por imagem, apenas custos de token conforme a página de preços do próprio modelo. A entrada de visão desse modelo é cobrada por token como qualquer outra entrada, e não por um valor fixo por imagem, então fotos maiores ou mais complexas (mais itens, mais detalhes a descrever) custarão mais do que o teste de flat lay acima. Se você vai rodar esse fluxo na escala de um catálogo, faça o orçamento por token e não por imagem, e consulte as tarifas atuais antes de definir o uso mensal — são justamente o tipo de número que muda.

Perguntas frequentes

O claude-opus-4-8 consegue gerar imagens de produto? Não. Ele traz as etiquetas Reasoning e Vision, e não Image Generation, e cada resposta que retorna é texto. Se o trabalho real é produzir novas fotos de produto ou fotos lifestyle, isso exige um modelo de imagem, não este.

O claude-opus-4-8 realmente suporta entrada de imagem no hiapi? Sim — confirmado ao enviar uma imagem real na solicitação acima e obter uma resposta baseada na imagem no caminho padrão. O model card do caminho claude-opus-4-8-aws documenta explicitamente a entrada de imagem; o model card do caminho padrão não menciona isso, o que vale saber antes de assumir que o model card é toda a verdade.

Qual caminho devo usar, o padrão ou o AWS? Para cargas de trabalho de e-commerce de texto e visão como as três acima, use o caminho padrão claude-opus-4-8 — é o mesmo modelo, com preço por token de 1/2,5 do claude-opus-4-8-aws.

Quanto custa o controle de qualidade de uma foto de produto? O teste de flat lay acima custa cerca de $0,0075 (769 tokens). Uma foto mais simples de um único item com um conjunto de regras mais curto custará menos; imagens mais densas ou rubricas mais longas custarão mais, porque a entrada de visão é cobrada por token.

Primeiros passos

Experimente você mesmo: uma chave de API hiapi, as especificações atuais do caminho padrão na página do modelo claude-opus-4-8, ou, se você precisa especificamente desse roteamento, em claude-opus-4-8-aws. Se você vai construir um fluxo de trabalho de conteúdo de e-commerce mais amplo no hiapi, o artigo de e-commerce do kimi-k3 cobre os mesmos cenários de redação e suporte com outro modelo, e vale comparar com os resultados acima antes de escolher um modelo para produção.