Применение kimi-k3 в электронной коммерции: генерация описаний товаров и ответов службы поддержки через API hiapi

Команды электронной коммерции ежедневно создают массу коротких структурированных текстов: названия товаров, списки ключевых пунктов, ответы на вопросы о размерах, ответы по политике возврата, ответы на отзывы. Эти задачи не требуют, чтобы универсальная чат-модель тратила множество токенов на многостраничные рассуждения, — но модели нужно быть достаточно быстрой, выдавать достаточно согласованные результаты и стоить настолько дёшево, чтобы её можно было запускать для каждого SKU и каждого тикета поддержки.

kimi-k3, доступная через API hiapi, — это чисто текстовая модель рассуждения, разработанная именно для таких нагрузок. Она не поддерживает вывод изображений или видео — если вы ищете генерацию изображений товаров с помощью ИИ, обратитесь к руководству по рабочему процессу gpt-image-2 в электронной коммерции. Сильная сторона kimi-k3 — превращение неаккуратных спецификаций товара или эмоциональных клиентских сообщений в чистый текст, соответствующий тону бренда, с дополнительным бюджетом рассуждений, позволяющим платить только за действительно необходимые размышления.

Это руководство охватывает два конкретных сценария электронной коммерции — написание описаний товаров и ответы службы поддержки — с реальными вызовами API, реальным расходом токенов и реальной стоимостью одного запроса.

Почему сценарии электронной коммерции подходят для текстовых моделей

Большинство текстовых задач электронной коммерции одношаговые и чётко ограниченные: переписать эту таблицу спецификаций в пять ключевых пунктов, ответить на этот один вопрос о возврате, составить название товара в пределах ограничения по символам. Вам не нужны возможности зрения или многошаговый вызов инструментов — нужна модель, которая надёжно следует инструкциям по формату и не выдумывает детали политики.

kimi-k3 на одной конечной точке Chat Completions предлагает три уровня reasoning_effort (low, high, max), поэтому вы можете повысить рассуждения для сообщений, требующих реального применения политики (например, определение права на возврат), и понизить их для задач, которые в основном связаны с форматированием (например, переписать ключевые пункты спецификации в маркетинговый текст). Это тот механизм регулировки затрат, который большинство чат-моделей с одним фиксированным уровнем предложить не может.

Сценарий первый: написание описаний товаров по таблице спецификаций

Типичная задача каталога: взять сырую спецификацию — размеры, материал, несколько функциональных описаний — и превратить её в название и список ключевых пунктов, соответствующие ограничениям площадки по символам и не преувеличивающие функции товара.

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

При reasoning_effort, установленном в low, модель «думает» гораздо меньше секунды и возвращает ответ, создавая готовый к вставке текст страницы товара:

Название товара (69 символов): Stainless Steel Pour Over Coffee Dripper, 1-2 Cup Cone Filter, Matte Black

• Точная экстракция пуровером — коническая воронка из нержавеющей стали, рассчитанная на 1–2 чашки, даёт вам полный контроль над процессом экстракции и позволяет каждый раз получать чистый, насыщенный вкусом кофе.
• Прочная нержавеющая сталь — изготовлена из нержавеющей стали с матовым чёрным покрытием, красиво смотрится и на кухонной столешнице, и на кофейной барной стойке.
• Многоразовая конструкция конической воронки — самой воронке не нужны бумажные фильтры; наслаждайтесь экологичным и экономным способом заваривания дома и в поездках.
• Легко чистить и брать с собой — можно мыть в посудомоечной машине, чистка не доставляет хлопот; в комплекте идёт чехол, чтобы вы могли заваривать любимый кофе где угодно.

Обратите внимание на примечание, которое модель добавила сама после списка ключевых пунктов: она отметила, что утверждение о «многоразовой воронке» зависит от детали спецификации, которая не была предоставлена (нужен ли этой воронке бумажный фильтр). В автоматизированном конвейере создания текстов такое проактивное указание на неопределённость — именно то, что нужно: оно сигнализирует, что товар следует отправить на ручную проверку, а не публиковать непроверенные утверждения.

Реальный расход этого вызова: 184 токена промпта, 239 токенов завершения (включая 10 токенов рассуждений), общая стоимость $0.0032.

Сценарий второй: ответы службы поддержки

Вопросы службы поддержки требуют больше реальных рассуждений, чем написание текстов, — модель должна правильно применять политику, а не просто переформатировать текст. Именно здесь повышение reasoning_effort оправдывает себя.

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

Ответ:

Хорошие новости — вы имеете право на возврат! Согласно нашей политике, процесс выглядит следующим образом:

Право на возврат: да, возврат возможен. Мы принимаем возвраты в течение 30 дней, если товар не использовался и сохранена оригинальная упаковка. Вы оформили заказ 10 дней назад и ещё не вскрыли товар, поэтому 조건 соблюдены.

Стоимость обратной доставки: поскольку товар был отправлен правильно (размер был выбран неверно при оформлении заказа, а не отправлен нами не тот товар), расходы на обратную доставку несёте вы. Мы берём на себя стоимость обратной доставки только в случае, если товар прибыл повреждённым или был отправлен не тот товар.

Сроки возврата средств: после получения возврата нашим складом деньги будут возвращены на исходный способ оплаты в течение 5–7 рабочих дней.

Модель правильно различила «клиент выбрал неверный размер» и «мы отправили не тот товар» — это различие определяет, кто оплачивает обратную доставку, — вместо того чтобы просто сопоставлять шаблон по слову «возврат». Именно такое применение политики требует проверки человеком перед отправкой в качестве автоматического ответа, но это прочный черновик, который оператор службы поддержки может одобрить за несколько секунд, а не набирать с нуля.

Реальный расход этого вызова: 222 токена промпта, 207 токенов завершения (включая 45 токенов рассуждений — более чем вдвое больше, чем в вызове для написания текста, что отражает дополнительную работу по рассуждению о политике), общая стоимость $0.0029.

Замечания о стоимости при масштабной работе

Цена kimi-k3 на hiapi составляет $2.32 за миллион входных токенов и $11.60 за миллион выходных токенов, кэшированный ввод тарифицируется по $0.232 за миллион — скидка 90% по сравнению с совершенно новыми входными токенами. Если ваша система поддержки повторно использует один и тот же текст политики в качестве system prompt в тысячах тикетов, этот system prompt — сильный кандидат на кэширование промпта: по полной цене оплачиваются только сообщения клиентов и ответы модели, а повторяющийся блок политики при попадании в кэш тарифицируется по кэшированному тарифу.

Для написания текстов в масштабе каталога товаров reasoning_effort: "low" позволяет задачам, которые в основном связаны с переформатированием, а не рассуждением, сохранять низкий расход токенов завершения (и тем самым снижать стоимость). Оставьте high или max для задач, где ошибка в логике (например, расчёт возврата, исключения по гарантии) обходится гораздо дороже, чем чуть более медленный ответ.

Полный справочник параметров, включая response_format для структурированного вывода JSON и поддержку потоковой передачи, см. в документации kimi-k3.

Быстрый старт

Оба примера выше работают на одной и той же странице модели kimi-k3 и конечной точке — достаточно заменить system prompt и значение reasoning_effort под вашу задачу, и у вас будет рабочий конвейер написания текстов или ответов службы поддержки за один вызов API. Ознакомьтесь с текущими ценами, чтобы узнать обо всех доступных моделях, получите API-ключ и начните с небольшим количеством реальных спецификаций товаров или реальных (анонимизированных) тикетов поддержки, а не с синтетических тестовых данных — качество вывода проще всего оценить на неаккуратном реальном тексте, который модель фактически увидит в производственной среде.