Claude Opus 4.8 para comercio electrónico: redacción de textos, control de calidad visual y atención al cliente mediante la API de hiapi

claude-opus-4-8 lleva en hiapi las etiquetas LLM, Reasoning, Vision, Streaming, Tool Calls. En ningún sitio aparece la etiqueta Image Generation: no genera imágenes. Por eso, cuando alguien pide «imágenes de producto», la respuesta honesta es que ha elegido el modelo equivocado. Sus verdaderas fortalezas en una tienda online son leer imágenes y redactar texto: evaluar fotos de producto según tus propias reglas de control de calidad, escribir textos de producto y responder a preguntas de atención al cliente. A continuación se presentan tres llamadas reales a la API de hiapi, con la salida real y el coste real de cada una.

Por qué elegir claude-opus-4-8 para textos e imágenes en comercio electrónico

claude-opus-4-8 está disponible en hiapi por dos vías que apuntan al mismo modelo pero con precios distintos:

• claude-opus-4-8 (predeterminada): la vía más barata.
• claude-opus-4-8-aws: enrutada por la infraestructura de AWS, con un coste de tokens de entrada y salida exactamente 2,5 veces mayor que la vía predeterminada.

Para redacción de textos de comercio electrónico, respuestas de atención al cliente y control de calidad de fotos, estas tareas no necesitan ninguna capacidad adicional que ofrezca la vía de AWS aparte del enrutamiento, así que la vía predeterminada es la que conviene elegir. Consulta las cifras completas y actualizadas en la página de precios de hiapi; revísala antes de decidir la ruta, porque el precio por token es justo el tipo de cifra que cambia con el tiempo.

Antes de empezar con los ejemplos, conviene advertir una cosa: la propia ficha del modelo de la vía predeterminada lo describe como generación de texto, salida en streaming y llamadas a herramientas, sin mencionar en absoluto la entrada de imágenes. La ficha de claude-opus-4-8-aws dice explícitamente: «admite entrada de texto e imágenes». En las pruebas siguientes, la vía predeterminada gestionó correctamente las solicitudes con entrada de imágenes de todos modos. La lección no es «fiarse de la etiqueta de visión antes que de la ficha del modelo» ni «fiarse de la ficha del modelo antes que de la etiqueta», sino que, cuando la ficha del modelo y las etiquetas de capacidades no coinciden, la única respuesta fiable es enviar una solicitud real y leer la respuesta real, que es exactamente lo que hace el resto de este artículo.

Caso de uso 1: control de calidad de fotos de producto mediante Vision

La idea es la siguiente: en lugar de que una persona revise a mano cada foto nueva que se publica, se entrega al modelo un conjunto breve de reglas y una foto, y se le pide que señale cualquier problema antes de que el producto salga a la venta.

La foto de prueba elegida aquí es a propósito un caso realmente malo: una composición cenital de unos diez accesorios sin relación entre sí (cartera, gafas de sol, pajarita, bolígrafo, cuaderno, móvil, reloj, auriculares) sobre un fondo oscuro, en lugar de una toma limpia de un solo artículo. El objetivo es ver si el modelo lo detecta de verdad en lugar de aprobarlo sin más.

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

Respuesta real, sin editar:

Regla 1: centrado y completamente visible: MARCADO. No es una toma de un solo producto. Es una composición cenital con unos diez artículos (cartera con cremallera, gafas de sol, pajarita, bolígrafo, tarjetero, cuaderno, portatarjetas, móvil, reloj, gafas, auriculares) dispersos sobre una cuadrícula, con amplios márgenes vacíos alrededor. Ningún artículo está en el centro, y cualquier ficha de producto que use esta imagen carecerá de un sujeto claro. Si lo que se vende es uno de esos productos, necesita un recorte individual.

Regla 2: fondo limpio/neutro: APROBADO. Superficie de color gris oscuro sin costuras, uniforme en toda la imagen, sin accesorios ni patrones que compitan por la atención. El tono de las cuatro esquinas es consistente.

Regla 3: sin daños ni defectos visibles: APROBADO (con reservas). Nada parece tener grietas, arañazos ni desgarros, y no hay ningún embalaje en la imagen. Cabe señalar que esta evaluación está limitada por la resolución y la escala: aquí no se pueden detectar pequeños arañazos ni defectos de costura en artículos de piel, así que si la comprobación de daños es importante para este SKU, usa una toma más cercana.

Regla 4: iluminación suficiente para mostrar el color real: MARCADO. La exposición es oscura y la caída de sombras es pronunciada, sobre todo en la esquina inferior izquierda y en el borde inferior. El negro no se ve negro: la cartera, el portatarjetas y el móvil parecen ligeramente cálidos/oliva, y el borde «verde» del cuaderno es ambiguo. El comprador no puede juzgar el color con fiabilidad a partir de esto. Una iluminación más brillante, más uniforme y más alta en clave resolvería el problema.

General: MARCADO: no publicar tal cual. La imagen es una composición de estilo de vida con varios artículos, no una foto de producto individual conforme, y está subexpuesta como para mostrar los colores con precisión. Vuelve a fotografiar un único producto centrado sobre el mismo fondo neutro con iluminación uniforme, o recorta un solo artículo y vuelve a ajustar la exposición.

Detectó los problemas reales (varios productos, ningún sujeto claro) en lugar de limitarse a describir la imagen, y en la regla 3 dejó correctamente un margen de duda en vez de afirmar con exceso de certeza a partir de una imagen de baja resolución, una advertencia que la mayoría de los scripts de comprobación de rúbricas no se les ocurriría añadir por sí solos.

Esta llamada usó 769 tokens (143 de prompt + 626 de finalización), unos $0,0075 en total por la vía predeterminada.

Caso de uso 2: redacción de textos de producto

El mismo modelo, esta vez texto puro: convertir una tabla de especificaciones en una ficha de producto.

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

Respuesta real, sin editar:

Título: Cartera slim con cremallera perimetral de piel plena flor: 6 ranuras + billetes

Características:

• Piel plena flor con bordes cosidos a mano, resistente al uso diario
• Estructura de perfil bajo que aloja 6 tarjetas y billetes doblados
• Cierre de cremallera perimetral que mantiene todo seguro; tamaño adecuado para el bolsillo delantero

Descripción: Esta cartera con cremallera perimetral aloja seis tarjetas y billetes en una estructura lo bastante delgada para el bolsillo delantero. La piel plena flor y los bordes cosidos a mano hacen que envejezca bien con el uso y se mantenga en buen estado durante años de transporte diario.

Sin «premium», sin «imprescindible», sin signos de exclamación: cumplió la instrucción de «sin superlativos», que suele ser donde fallan los prompts de copywriting. En total 364 tokens, unos $0,0026.

Caso de uso 3: respuesta de atención al cliente

Se le entrega la política de devoluciones real y el mensaje real de un cliente, y redacta una respuesta que una persona puede enviar con ligeras ediciones (o sin ninguna).

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

Respuesta real, sin editar:

Lo siento mucho: encontrar un arañazo en una cartera nueva es realmente decepcionante, y es comprensible que esperaras más de nosotros.

La respuesta a tus dos preguntas es favorable para ti:

• Plazo de devolución: han pasado 3 semanas desde que la recibiste, así que sigues dentro de nuestra política de 30 días.
• Gastos de envío: que llegara con un arañazo cuenta como daño, así que nosotros corremos con los gastos de devolución. No tendrás que pagar nada por enviarla.

Próximo paso: envíanos tu número de pedido y una foto del panel frontal con el arañazo. Emitiremos una etiqueta prepagada y pondremos en marcha el cambio.

Si prefieres cambiar a otra cartera en lugar de un reemplazo directo, dínoslo y nos encargamos de la diferencia de precio.

Aplicó correctamente las dos reglas de la política (plazo + gastos de envío por daño), en lugar de elegir solo una, y se mantuvo dentro del límite de 150 palabras. 385 tokens, unos $0,0028.

Nota sobre costes

Las tres llamadas anteriores se ejecutaron por la vía predeterminada claude-opus-4-8, con un total de 1.518 tokens y unos $0,013 en conjunto: sin generación de imágenes, sin tarifa por imagen, solo el coste de tokens de la propia página de precios del modelo. La entrada de visión de este modelo se factura por tokens como cualquier otra entrada, no con una tarifa fija por imagen, así que fotos más grandes o complejas (más artículos, más detalles que describir) costarán más que la prueba cenital anterior. Si vas a ejecutar este flujo a escala de catálogo, presupuesta por tokens y no por imagen, y consulta las tarifas vigentes antes de fijar el uso mensual: son justo el tipo de cifra que cambia.

Preguntas frecuentes

¿Puede claude-opus-4-8 generar imágenes de producto? No. Lleva las etiquetas Reasoning y Vision, no Image Generation, y cada respuesta que devuelve es texto. Si el trabajo real es crear nueva fotografía de producto o imágenes de estilo de vida, hace falta un modelo de imagen, no este.

¿Admite realmente claude-opus-4-8 la entrada de imágenes en hiapi? Sí: se confirmó enviando una imagen real en las solicitudes anteriores y obteniendo una respuesta basada en la imagen por la vía predeterminada. La propia ficha del modelo de la vía claude-opus-4-8-aws documenta explícitamente la entrada de imágenes; la ficha de la vía predeterminada no lo menciona, algo que conviene saber antes de dar por sentado que la ficha del modelo es toda la verdad.

¿Qué vía debo usar, la predeterminada o AWS? Para cargas de trabajo de comercio electrónico de texto y visión como las tres anteriores, usa la vía predeterminada claude-opus-4-8: es el mismo modelo y el precio por token es 1/2,5 del de claude-opus-4-8-aws.

¿Cuánto cuesta revisar una foto de producto? La prueba cenital anterior costó unos $0,0075 (769 tokens). Una foto más simple de un solo producto con un conjunto de reglas más breve saldrá más barata; una imagen más densa o una rúbrica más larga saldrá más cara, porque la entrada de visión se factura por tokens.

Cómo empezar

Pruébalo tú mismo: necesitas una clave de API de hiapi, las especificaciones actuales de la vía predeterminada en la página del modelo claude-opus-4-8, o, si necesitas específicamente ese enrutamiento, claude-opus-4-8-aws. Si vas a construir un flujo de trabajo de contenido de comercio electrónico más amplio en hiapi, el artículo sobre kimi-k3 para comercio electrónico cubre los mismos escenarios de redacción de textos y soporte con otro modelo, y merece la pena compararlo con los resultados anteriores antes de elegir un modelo para producción.