HiAPI
Blog

Guide d'utilisation

Applications de kimi-k3 dans le e-commerce : générer des fiches produit et des réponses au service client via l'API hiapi

Deux appels API réels montrent comment un modèle de raisonnement texte pur peut rédiger des fiches catalogue et des réponses de support client conformes aux politiques, pour moins d'un centime par requête.

Sep 16, 2026
Applications de kimi-k3 dans le e-commerce : générer des fiches produit et des réponses au service client via l'API hiapi

Les équipes e-commerce doivent produire chaque jour une grande quantité de textes courts et structurés : titres de produits, listes de points clés, questions-réponses sur les guides des tailles, réponses aux politiques de retour, réponses aux avis. Ces tâches n'exigent pas qu'un modèle de chat généraliste consomme des quantités massives de tokens pour un raisonnement de plusieurs pages — mais elles exigent un modèle suffisamment rapide, avec des sorties suffisamment cohérentes, et un coût assez faible pour être exécuté sur chaque SKU et chaque ticket de support.

kimi-k3, disponible via l'API hiapi, est un modèle de raisonnement texte pur conçu précisément pour ce type de charge de travail. Il ne prend pas en charge la sortie d'images ou de vidéos — si vous cherchez à générer des visuels produit par IA, consultez le guide du workflow e-commerce gpt-image-2. Ce que kimi-k3 réussit vraiment, c'est transformer des spécifications produit désordonnées ou des messages client chargés d'émotion en textes propres et conformes à l'image de marque, tout en offrant un budget de raisonnement optionnel qui vous permet de ne payer que pour la réflexion réellement nécessaire.

Ce guide couvre deux cas d'usage concrets du e-commerce — la rédaction de fiches produit et les réponses au service client — avec de vrais appels API, une réelle consommation de tokens et de réels coûts par requête.

Pourquoi le e-commerce convient aux modèles texte pur

La plupart des tâches textuelles en e-commerce sont à tour unique et bien délimitées : transformer cette fiche de spécifications en cinq points clés, répondre à cette question de retour, rédiger un titre produit dans la limite de caractères. Vous n'avez pas besoin de capacités visuelles ni d'appels d'outils multi-étapes — vous avez besoin d'un modèle qui respecte de manière fiable les instructions de formatage et n'invente pas de détails de politique.

kimi-k3 propose trois niveaux de reasoning_effort (low, high, max) sur le même point de terminaison Chat Completions, ce qui vous permet d'augmenter le raisonnement pour les messages nécessitant une véritable application de politique (comme l'évaluation de l'éligibilité à un retour), et de le réduire pour les tâches essentiellement de reformatage (comme la réécriture de points de spécifications en texte marketing). C'est un levier de maîtrise des coûts que la plupart des modèles de chat à niveau unique ne peuvent pas offrir.

Cas d'usage 1 : rédiger des fiches produit à partir de spécifications

Une tâche catalogue typique : prendre des spécifications brutes — dimensions, matériaux, quelques descriptions de fonctionnalités — et les transformer en un titre plus une liste de points clés qui respectent les limites de caractères de la plateforme e-commerce sans exagérer les fonctionnalités du produit.

curl https://api.hiapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kimi-k3",
    "reasoning_effort": "low",
    "messages": [
      {
        "role": "system",
        "content": "You write e-commerce product listings. Output a title under 70 characters and 4 bullet points in ALL-CAPS-LEAD style. Do not claim features not in the spec."
      },
      {
        "role": "user",
        "content": "Product: pour-over coffee dripper. Material: stainless steel. Capacity: 1-2 cups. Color: matte black. Includes travel pouch. Dishwasher safe."
      }
    ]
  }'

Avec reasoning_effort défini sur low, le modèle renvoie une réponse en bien moins d'une seconde de « réflexion » et produit une fiche produit prête à coller :

Titre du produit (69 caractères) : Stainless Steel Pour Over Coffee Dripper, 1-2 Cup Cone Filter, Matte Black

  • EXTRACTION DE PRÉCISION POUR OVER — Filtre conique en acier inoxydable conçu pour 1 à 2 tasses, vous donnant un contrôle total sur l'extraction pour une tasse de café propre et pleine de saveur à chaque fois.
  • ACIER INOXYDABLE DURABLE — Fabriqué en acier inoxydable avec une finition noir mat, aussi élégant sur le plan de travail de la cuisine que sur le bar à café.
  • CONCEPTION DE FILTRE CONIQUE RÉUTILISABLE — Le filtre lui-même ne nécessite aucun filtre papier ; profitez d'une expérience de brassage durable et économique, à la maison comme en déplacement.
  • FACILE À NETTOYER ET PORTABLE — Passe au lave-vaisselle pour un nettoyage sans effort ; livré avec une pochette de transport pour préparer votre café préféré où que vous soyez.

Notez la remarque que le modèle ajoute de lui-même après la liste de points clés : il signale que l'affirmation « filtre réutilisable » dépend d'un détail de spécification non fourni (si ce filtre nécessite ou non un filtre papier). Dans un pipeline de rédaction automatisé, ce signalement proactif d'une incertitude est exactement ce que vous voulez — il indique qu'il faut renvoyer le produit à une révision humaine plutôt que de publier une affirmation non vérifiée.

Consommation réelle de cet appel : 184 tokens de prompt, 239 tokens de complétion (dont 10 tokens de raisonnement), coût total $0.0032.

Cas d'usage 2 : réponses au service client

Les questions de support client exigent plus de raisonnement réel que la rédaction de fiches — le modèle doit appliquer correctement la politique, pas seulement reformater du texte. C'est là que l'augmentation de reasoning_effort prend toute sa valeur.

curl https://api.hiapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kimi-k3",
    "reasoning_effort": "high",
    "messages": [
      {
        "role": "system",
        "content": "You are a support agent. Return policy: returns accepted within 30 days if unused and in original packaging. Customer pays return shipping unless the item arrived damaged or wrong. Refunds post 5-7 business days after warehouse receives the item."
      },
      {
        "role": "user",
        "content": "I ordered the wrong size 10 days ago, item is unopened. Can I return it, and who pays shipping?"
      }
    ]
  }'

Réponse :

Bonne nouvelle — vous êtes éligible à un retour ! Voici comment cela fonctionne selon notre politique :

Éligibilité au retour : Oui, vous pouvez le retourner. Nous acceptons les retours dans les 30 jours, à condition que l'article soit inutilisé et dans son emballage d'origine. Vous avez commandé il y a 10 jours et l'article n'est pas ouvert, vous êtes donc éligible.

Frais de retour : Comme l'article a été expédié correctement (c'est vous qui avez choisi la mauvaise taille lors de la commande, et non nous qui avons envoyé le mauvais article), les frais de retour sont à votre charge. Nous prenons en charge les frais de retour uniquement si l'article est arrivé endommagé ou si le mauvais article a été expédié.

Délai de remboursement : Une fois l'article retour reçu par notre entrepôt, le remboursement sera effectué sur votre moyen de paiement d'origine sous 5 à 7 jours ouvrés.

Le modèle a correctement distingué « le client a commandé la mauvaise taille » de « nous avons expédié le mauvais article » — une distinction qui détermine qui paie les frais de retour — au lieu de simplement faire correspondre le mot « retour ». C'est exactement le type d'application de politique qui nécessite une révision humaine avant d'être envoyée comme réponse automatique, mais c'est un brouillon solide que l'agent humain peut valider en quelques secondes au lieu de taper depuis zéro.

Consommation réelle de cet appel : 222 tokens de prompt, 207 tokens de complétion (dont 45 tokens de raisonnement — plus du double de ceux de l'appel de rédaction, ce qui reflète le travail de raisonnement supplémentaire sur la politique), coût total $0.0029.

Note sur les coûts à grande échelle

kimi-k3 sur hiapi est tarifé à $2.32 par million de tokens d'entrée, $11.60 par million de tokens de sortie, et les entrées mises en cache à $0.232 par million — soit une remise de 90 % par rapport aux nouveaux tokens d'entrée. Si votre système de support réutilise le même texte de politique comme system prompt sur des milliers de tickets, ce system prompt est un excellent candidat à la mise en cache : seuls le message client et la réponse du modèle sont facturés au plein tarif, et le bloc de politique répété est facturé au tarif cache en cas de succès du cache.

Pour la rédaction à l'échelle d'un catalogue, reasoning_effort: "low" maintient une consommation de tokens de complétion faible (donc un coût réduit) sur les tâches qui sont essentiellement du reformatage plutôt que du raisonnement. Réservez high ou max aux tâches où une erreur de logique (comme un calcul de remboursement ou une exception de garantie) coûte bien plus cher qu'une réponse légèrement plus lente.

Pour la référence complète des paramètres, y compris response_format pour la sortie JSON structurée et la prise en charge du streaming, consultez la documentation kimi-k3.

Pour démarrer rapidement

Les deux exemples ci-dessus s'exécutent sur la même page du modèle kimi-k3 et le même point de terminaison — il suffit de remplacer le system prompt et la valeur de reasoning_effort pour l'adapter à votre tâche, et vous disposez d'un pipeline de rédaction ou de réponse support fonctionnel en un appel API. Consultez la tarification actuelle pour découvrir tous les modèles disponibles, obtenez une clé API, et commencez avec un petit nombre de vraies spécifications produit ou de vrais tickets support (anonymisés) plutôt qu'avec des données de test synthétiques — c'est sur des textes réels désordonnés, ceux que le modèle verra réellement en production, qu'il est le plus facile de juger la qualité de ses sorties.

Articles similaires

Voir tous les articles →

Commencez avec des artefacts IA persistants

Obtenez votre clé API et appelez des modèles d'image, de vidéo et d'audio via une API unique basée sur les tasks.

Lire la documentation de l'API