Многие команды, подключая Kling, сначала выбирают посредника или прокси: поменять Base URL и ключ — выглядит проще, чем прямое подключение. Но генерация видео — асинхронная задача, и посредническая цепочка добавляет к текстовому интерфейсу сохранение задач, отображение статусов, пересылку callback и перекладывание результатов. Если хотя бы одно звено слабое, симптом будет один: «задача отправлена успешно, а видео получить нельзя».

Разберём реальную цепочку посредника: надёжность задач, хранение результатов, прозрачность биллинга, риски ключей и приёмку при миграции с прямого подключения.

Примечание: Kling и Kuaishou — товарные знаки Kuaishou и связанных с ней компаний. Статья носит технический характер; автор не связан с Kuaishou и не сотрудничает с компанией. Интерфейсы, модели и правила биллинга определяются официальной документацией и страницей тарифов; цены могут меняться.

1. Четыре вида «посредников»: сначала поймите, что покупаете

Тип Что фактически предоставляет Основной риск Для чего подходит
Обратный прокси Передаёт запросы во внешний интерфейс Единая точка отказа, пропускная способность, настройка авторизации Есть DevOps, нужен только единый выход
Агрегирующий шлюз Единый вход, объединяет несколько видеомоделей Отображение статусов, различия параметров, перекладывание результатов Несколько моделей, небольшая команда
Дистрибуция и пополнение Перепродажа лимитов или оплата за клиента Стабильность поставщика, условия обслуживания, сохранность баланса Временное тестирование, небольшой объём
Собственный шлюз Самостоятельное развёртывание и поддержка слоя пересылки Серверы, сертификаты, защита от злоупотреблений Нужен контроль данных и есть команда

То, что вы покупаете — «технический сервис» или «лимит модели», — определяет, кто отвечает при сбое, кто выставляет счёт и с кем подписан договор об обработке данных. Сверяйте договор и счёт с этим различием, а не только с надписью «Kling» на странице.

2. Как статусы задачи проходят через посредника

Ваш бизнес
  → вход посредника (авторизация, лимиты, биллинг)
  → создание задачи у поставщика, возврат id задачи
  → посредник сохраняет связь id задачи и номера бизнес-заказа
  → посредник опрашивает поставщика или принимает callback
  → отображение в единый статус, интерфейс запроса или webhook
  → вы скачиваете и перекладываете результат

В новом официальном интерфейсе статусы обычно submitted, processing, succeeded, failed; старый интерфейс может обозначать успех как succeed. Если посредник отображает только успех и ошибку, бизнес может бесконечно ждать processing; если задача у поставщика истекает, нужен отдельный статус вроде expired.

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

3. Хранение и перекладывание результатов

Официальная документация указывает, что URL результатов очищаются через 30 дней, а адрес имеет защиту от внешних ссылок. У посредника есть три типовых подхода с совершенно разной ответственностью:

  • Передача адреса поставщика: вызывающая сторона сама отвечает за перекладывание в течение 30 дней.
  • Кэш или прокси-адрес: нужно письменно зафиксировать, будет ли запрос к источнику после истечения, сколько хранится кэш и есть ли доплата.
  • Управляемое хранение: посредник скачивает и хранит долго; уточните место хранения, права доступа, механизм удаления и срок.

«Постоянная ссылка» звучит удобно, но если посредник просто направляет свой домен на адрес поставщика с ограниченным сроком, после истечения она тоже перестанет открываться. При приёмке проверьте ссылку через 24 часа после успеха и ближе к 30-му дню.

4. Как проверить прозрачность биллинга

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

Для сверки требуйте как минимум: ID задачи, номер бизнес-заказа, модель, длительность, разрешение, статус, сумму списания и валюту. В официальном callback поле billing различает списание денег и пакета, указывает сумму, валюту и тип тарифа; передаёт ли посредник эти поля без изменений — прямой критерий прозрачности.

Также уточните, тарифицируются ли сбой, таймаут, отмена и отказ модерации, есть ли дедупликация повторных отправок, как устроены возвраты и счета. Конкретные цены — на странице тарифов. До договора прогоните 20–50 небольших задач в течение недели и сверьте успешные, неуспешные и счёт построчно.

5. Ключи, данные и риски поставщика

Запрос проходит через третью сторону: промпты, первые кадры и готовые видео могут быть видны или сохранены. До закупки уточните:

  1. Можно ли ограничить ключ по сумме, IP и сроку; можно ли быстро заблокировать при утечке.
  2. Сохраняются ли запросы и результаты, сколько, где и у кого есть доступ.
  3. Используются ли данные для обучения или улучшения сервиса, можно ли подписать соглашение об обработке.
  4. Один у поставщика канал или несколько; как сообщают о снятии модели или смене версии.
  5. Разрешают ли условия перепродажу или посредничество, где граница ответственности в споре.
  6. Кто подписывает callback, какое окно метки времени, как отклоняются повторные запросы.

Production-ключ нельзя писать во фронтенд, репозиторий или скриншоты тикетов. Для чувствительных материалов выбирайте поставщика, который не сохраняет данные или готов подписать соглашение; если это не подтверждено, обезличьте материалы до загрузки. Ключ Kling в консоли обычно показывается полностью один раз; если он потерян, создайте новый, а не пытайтесь угадать.

6. Шаги миграции с прямого подключения на посредника

  1. Инвентаризируйте текущие вызовы: модели, параметры, параллельность, среднюю длительность и типы сбоев.
  2. Составьте таблицу соответствия: домены, авторизация, поля, значения статусов и коды ошибок.
  3. В тестовой среде проверьте четыре пути: создание, запрос, callback и скачивание.
  4. Запустите теневой режим на одном наборе задач: прямое подключение и посредник параллельно, только сравнение без переключения.
  5. Сравните успешность, P95 задержки, долю скачиваемых результатов и стоимость одного успешного видео.
  6. Переводите трафик постепенно, 5–20%, сохранив переключатель возврата на прямое подключение.
  7. Наблюдайте 3–7 дней: счета, детализация задач и номера заказов должны сходиться.
  8. После полного перехода оставьте резервный канал, затем упростите архитектуру.

Во время миграции не удаляйте ключ прямого подключения и не пишите задачи двух каналов под одним номером заказа, иначе сверка станет невозможной.

7. Как проверить посредника

# 1. Отправьте минимальную задачу, сохраните id, номер заказа и время отправки
curl -X POST "$RELAY_BASE_URL/text-to-video/kling-2.6" \
  -H "Authorization: Bearer $RELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Кошка зевает у окна",
    "settings": {"duration": 5, "resolution": "720p", "aspect_ratio": "16:9"},
    "options": {"external_task_id": "relay-test-20261019-01"}
  }'

# 2. Опрашивайте каждые 10 секунд, фиксируйте полный переход статусов и ошибки
curl "$RELAY_BASE_URL/tasks?task_ids=$TASK_ID" \
  -H "Authorization: Bearer $RELAY_API_KEY"

На тестах специально создавайте аномалии: отмените сразу после отправки, передайте неверный ID модели, превысьте лимит параллельности, оборвите скачивание, отправьте callback повторно. Смотрите, совпадают ли статусы, коды ошибок и списания. Через 24 часа откройте ссылку на результат, через 7 дней проверьте запись задачи, ближе к 30-му дню ещё раз убедитесь, что ссылка и запись доступны.

8. Мониторинг и откат после миграции

  • Считайте задачи по статусам, особенно долю failed, cancelled и просроченных.
  • Фиксируйте общее время от отправки до успеха, разделяя очередь и генерацию.
  • Следите за долей успешных скачиваний; неуспешные отправляйте в очередь компенсации, а не в бесконечные повторы.
  • Считайте 401, 404, 429 и 5xx, разделяя проблемы ключа, модели, параллельности и поставщика.
  • Считайте стоимость одного успешного видео, а не только цену одного запроса.
  • Задайте порог отката, например: если два часа подряд успешность заметно ниже базовой, вернуться на прямое подключение.

Частые вопросы

Видео через посредника такое же, как при прямом подключении?

Зависит от того, передаёт ли посредник ту же модель и те же параметры. Версия модели, длительность, разрешение и поддержка аудио могут различаться; до интеграции прогоните несколько задач с одинаковым промптом и параметрами.

Сохраняет ли посредник мои видео?

У разных сервисов по-разному. Уточните, сохраняются ли данные, сколько, где, у кого доступ и как удаляются. Если в материалах есть данные клиентов, выбирайте поставщика с понятными условиями.

Задача потерялась на стороне посредника. Что делать?

Сначала найдите локальную запись по номеру заказа, затем проверьте логи посредника и задачу у поставщика. Если восстановить нельзя, остаётся отправить заново. Поэтому до миграции выясните, сохраняет ли посредник связь задач и умеет ли искать по номеру заказа.

Счёт не сходится с количеством задач. Почему?

Частые причины: повторные отправки, повторы после сбоев, разные правила отмены, минимальный платёж или истёкший пакет. Запросите детализацию списаний по ID задач и сверяйте построчно, а не только итог.

Сколько кода придётся изменить при миграции?

Если посредник совместим с официальным интерфейсом задач, обычно достаточно поменять домен, ключ и несколько полей. Если отличается отображение статусов или формат callback, придётся править опрос и запись в базу. Теневой режим заранее выявит большинство различий.

Что дальше

Создайте тестовый ключ в ZSQH AI Gateway, проверьте на минимальной задаче четыре цепочки — создание, опрос, callback и счёт — и переходите на постепенную миграцию. Модели и цены смотрите на странице тарифов; поддержка видео Kling определяется документацией платформы.

Читайте также: