Kling V3.0 4K: Быстрый старт с API

Kling V3.0 4K доступен на Novita AI как две выделенные конечные точки API: kling-v3.0-4k-t2v для преобразования текста в видео и kling-v3.0-4k-i2v для преобразования изображения в видео. Обе создают нативное видео с разрешением 3840×2160, поддерживают длительность от 3 до 15 секунд и следуют тому же асинхронному шаблону задач, который используется во всех виде API Novita. Если вы уже используете Kling V3.0 Standard или Pro в своём пайплайне, переход на уровень 4K — это изменение идентификатора модели в одной строке.

В этом руководстве рассматриваются только конечные точки для 4K. Информацию о создании собственного аудио, многокадровой композиции или ценах на Standard/Pro за секунду смотрите в обзоре запуска Kling 3.0 на Novita AI.

Когда использовать Kling V3.0 4K вместо Standard и Pro

Уровень 4K имеет смысл, когда выходное разрешение является ограничением — активы для печати, дисплеи большого размера или downstream-процессы, требующие кадров высокого разрешения для композитинга или кадрирования.

Он не заменяет Standard или Pro для всех случаев. Итерации и тестирование промптов дешевле при более низких разрешениях, а генерация в 4K занимает больше времени на задачу. Практичный рабочий процесс: итерируйте с помощью Standard, затем переключайтесь на kling-v3.0-4k-t2v или kling-v3.0-4k-i2v для финального принятого промпта.

Используйте kling-v3.0-4k-t2v, когда:

Сцену можно полностью описать в промпте
Нет референсного изображения или оно не имеет значения

Используйте kling-v3.0-4k-i2v, когда:

Конкретный первый кадр должен закрепить создаваемый клип
Вам нужно согласованное отображение объекта из исходного изображения

Шаг 1: Получите API-ключ Novita AI

Зарегистрируйтесь на novita.ai и сгенерируйте API-ключ в панели управления. Новые аккаунты получают бесплатные кредиты. Храните ключ как переменную окружения — не встраивайте его жёстко в исходные файлы.

export NOVITA_API_KEY="your_api_key_here"

Шаг 2: Идентификаторы моделей и конечные точки

Режим	Идентификатор модели	Конечная точка
Текст в видео	`kling-v3.0-4k-t2v`	`POST https://api.novita.ai/v3/async/kling-v3.0-4k-t2v`
Изображение в видео	`kling-v3.0-4k-i2v`	`POST https://api.novita.ai/v3/async/kling-v3.0-4k-i2v`
Получение результата	—	`GET https://api.novita.ai/v3/async/task-result?task_id=<id>`

Обе конечные точки принимают JSON, требуют токен Bearer в заголовке Authorization и немедленно возвращают task_id. Само видео извлекается отдельно через конечную точку результата задачи.

Ссылки на официальную документацию API:

Шаг 3: Отправьте ваш первый запрос

curl -X POST https://api.novita.ai/v3/async/kling-v3.0-4k-t2v \
  -H "Authorization: Bearer $NOVITA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A lone lighthouse on a rocky coast at golden hour, cinematic wide shot, waves crashing",
    "negative_prompt": "blurry, low quality, distorted",
    "duration": 5,
    "aspect_ratio": "16:9",
    "cfg_scale": 0.5
  }'

Ответ возвращает task_id:

{
  "task_id": "t2v-kling-4k-abc123"
}

Сохраните этот идентификатор — он понадобится для получения результата.

Шаг 4: Опрашивайте результат видео

curl "https://api.novita.ai/v3/async/task-result?task_id=t2v-kling-4k-abc123" \
  -H "Authorization: Bearer $NOVITA_API_KEY"

Завершённая задача возвращает объект task со статусом "TASK_STATUS_SUCCEED" и массив videos:

{
  "task": {
    "task_id": "t2v-kling-4k-abc123",
    "status": "TASK_STATUS_SUCCEED"
  },
  "videos": [
    {
      "video_url": "https://...",
      "video_url_ttl": 3600,
      "video_type": "mp4"
    }
  ]
}

Типичные значения статуса: TASK_STATUS_QUEUED, TASK_STATUS_PROCESSING, TASK_STATUS_SUCCEED, TASK_STATUS_FAILED. Стройте свой цикл опроса вокруг этих статусов — не предполагайте фиксированное время ожидания, так как генерация 4K занимает больше времени, чем 1080P.

Шаг 5: Запрос изображения в видео

Конечная точка изображения в видео требует дополнительно image_url помимо prompt. Изображение определяет первый кадр; модель генерирует движение на его основе.

curl -X POST https://api.novita.ai/v3/async/kling-v3.0-4k-i2v \
  -H "Authorization: Bearer $NOVITA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "The lighthouse beam sweeps across the fog, slow dramatic movement",
    "negative_prompt": "fast cuts, shake, low quality",
    "image_url": "https://your-storage.example.com/lighthouse-frame.jpg",
    "duration": 5,
    "aspect_ratio": "16:9",
    "cfg_scale": 0.5
  }'

Требования к изображению (проверьте актуальные ограничения в API-ссылке Novita):

Форматы: .jpg, .jpeg, .png
Максимальный размер файла: 10 MB
Минимальные размеры: 300×300 пикселей

Шаг получения результата идентичен T2V — опрашивайте /v3/async/task-result с полученным task_id.

Примеры на Python

T2V — текст в 4K видео

import os
import time
import requests

API_KEY = os.environ["NOVITA_API_KEY"]
BASE_URL = "https://api.novita.ai"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

def submit_t2v(prompt: str, duration: int = 5, aspect_ratio: str = "16:9") -> str:
    payload = {
        "prompt": prompt,
        "negative_prompt": "blurry, low quality",
        "duration": duration,
        "aspect_ratio": aspect_ratio,
        "cfg_scale": 0.5,
    }
    resp = requests.post(
        f"{BASE_URL}/v3/async/kling-v3.0-4k-t2v",
        headers=HEADERS,
        json=payload,
        timeout=30,
    )
    resp.raise_for_status()
    return resp.json()["task_id"]

def poll_result(task_id: str, interval: int = 10, max_wait: int = 600) -> dict:
    deadline = time.time() + max_wait
    while time.time() < deadline:
        resp = requests.get(
            f"{BASE_URL}/v3/async/task-result",
            headers=HEADERS,
            params={"task_id": task_id},
            timeout=30,
        )
        resp.raise_for_status()
        data = resp.json()
        status = data.get("task", {}).get("status", "")
        if status == "TASK_STATUS_SUCCEED":
            return data
        if status == "TASK_STATUS_FAILED":
            raise RuntimeError(f"Task failed: {data}")
        time.sleep(interval)
    raise TimeoutError(f"Task {task_id} did not complete within {max_wait}s")

if __name__ == "__main__":
    task_id = submit_t2v(
        prompt="A lone lighthouse on a rocky coast at golden hour, cinematic wide shot",
        duration=5,
        aspect_ratio="16:9",
    )
    print(f"Task submitted: {task_id}")
    result = poll_result(task_id)
    video_url = result["videos"][0]["video_url"]
    print(f"Video ready: {video_url}")

I2V — изображение в 4K видео

def submit_i2v(
    prompt: str,
    image_url: str,
    duration: int = 5,
    aspect_ratio: str = "16:9",
) -> str:
    payload = {
        "prompt": prompt,
        "negative_prompt": "blurry, low quality",
        "image_url": image_url,
        "duration": duration,
        "aspect_ratio": aspect_ratio,
        "cfg_scale": 0.5,
    }
    resp = requests.post(
        f"{BASE_URL}/v3/async/kling-v3.0-4k-i2v",
        headers=HEADERS,
        json=payload,
        timeout=30,
    )
    resp.raise_for_status()
    return resp.json()["task_id"]

Используйте ту же функцию poll_result для получения сгенерированного видео.

Ключевые параметры

Параметр	Тип	Обязательный	Примечания
`prompt`	string	Да	Описание сцены. Делайте его конкретным: объект, движение, ракурс камеры, освещение.
`negative_prompt`	string	Нет	Что подавить: размытие, дрожание, артефакты, нежелательные стили.
`duration`	integer	Нет	Длительность видео в секундах. Диапазон: `3`–`15`. Значение по умолчанию варьируется — проверьте документацию.
`aspect_ratio`	string	Нет	`"16:9"`, `"9:16"`, `"1:1"`. По умолчанию: `"16:9"`.
`cfg_scale`	float	Нет	Степень следования промпту. `0.5` — безопасное начальное значение.
`image_url`	string	Только I2V	Изображение первого кадра. Должен быть общедоступный URL.

Разрешение и длительность против стоимости

Генерация 4K стоит дороже за секунду, чем Standard или Pro. Прежде чем запускать полный пакет:

Тестируйте промпты с kling-v3.0-std-t2v при duration: 3
Переключайтесь на kling-v3.0-4k-t2v только для принятых промптов
Используйте duration: 5 для большинства результатов; резервируйте 10–15 секунд для геройских клипов

Цены и оценка стоимости

Novita AI использует посекундную оплату для Kling V3.0 4K. Цены на уровень 4K выше, чем на Standard или Pro — проверьте novita.ai/models/kling/kling-v3.0-4k-t2v и novita.ai/models/kling/kling-v3.0-4k-i2v для текущих посекундных тарифов перед запуском производственных пакетов.

Для контекста о уровнях Standard и Pro в обзоре запуска Kling 3.0 задокументированы посекундные тарифы для этих уровней. Уровень 4K тарифицируется отдельно.

Шаблон оценки стоимости для любой посекундной модели:

Определите длительность одного клипа (например, 5 секунд)
Умножьте на тариф за секунду
Умножьте на ожидаемое количество принятых клипов
Добавьте буфер на повторные попытки (10–20% для неудачных промптов)

Устранение неполадок

task_id получен, но результат никогда не успешен Задачи 4K занимают больше времени, чем эквиваленты 1080P. Увеличьте тайм-аут опроса минимум до 10 минут (max_wait=600). Если задача остаётся в TASK_STATUS_PROCESSING дольше, проверьте страницу статуса Novita или повторите запрос.

TASK_STATUS_FAILED без подробностей Наиболее частые причины: промпт содержит запрещённый контент, недействительный или недоступный image_url в режиме I2V, или значение длительности вне поддерживаемого диапазона. Проверьте входные данные и повторите с более простым промптом.

Изображение для I2V отклонено Убедитесь, что изображение доступно публично по прямому URL (без редиректов или авторизации), формат .jpg/.jpeg/.png, файл меньше 10 MB, и размеры не менее 300×300 пикселей.

Неожиданное выходное разрешение Конечные точки 4K нацелены на 3840×2160. Если ваш плеер или downstream-инструмент сообщает о более низком разрешении, проверьте, правильно ли он декодирует файл. Закодированный вывод от API должен быть нативным 4K.

Ошибки ограничения скорости Novita AI применяет ограничения скорости на каждый API-ключ. Для высокопроизводительных пакетных нагрузок ознакомьтесь с документацией по ограничениям скорости и рассмотрите возможность отправки задач последовательно или с небольшой задержкой между запросами.

Часто задаваемые вопросы

Какое разрешение создаёт `kling-v3.0-4k-t2v`?

Обе конечные точки 4K нацелены на выходное разрешение 3840×2160 (4K UHD). Это аппаратный рендер — не апскейл с более низкого разрешения.

Чем Kling V3.0 4K отличается от V3.0 Standard и Pro?

Standard и Pro генерируют выходное видео 1080P. Конечные точки 4K добавляют нативное разрешение 3840×2160. Standard — самый быстрый и дешёвый; Pro добавляет более высокое визуальное качество при умеренной стоимости; 4K — вариант с самым высоким разрешением и соответствующими ценами. Длительность (3–15 секунд) и форма асинхронного API одинаковы для всех трёх уровней.

Могу ли я использовать конечные точки 4K с тем же API-ключом, что и Standard и Pro?

Да. Все конечные точки Kling V3.0 на Novita AI используют одинаковую аутентификацию с токеном Bearer. Единственное изменение между уровнями — идентификатор модели и путь конечной точки.

Поддерживает ли Kling V3.0 4K создание собственного аудио?

Стандартный флаг совместной генерации аудио, доступный на конечных точках V3.0 Standard и Pro, может также поддерживаться на уровне 4K. Проверьте страницы API-ссылок T2V и I2V для текущего списка параметров, включая возможное поле with_audio.

Сколько времени занимает задача генерации 4K?

Генерация 4K занимает больше времени, чем 1080P. Ожидайте минимум 60–180 секунд для 5-секундного клипа, в зависимости от загрузки очереди. Проектируйте логику опроса с тайм-аутом не менее 10 минут и обрабатывайте TASK_STATUS_PROCESSING как нормальное промежуточное состояние.

Полезна ли конечная точка I2V для продуктовых или брендовых видео?

Да, когда входное изображение чистое и хорошо освещено. Конечная точка I2V хорошо сохраняет композицию первого кадра для стационарных объектов. Для сложного движения камеры или многоперсонажных сцен запустите небольшой тестовый пакет перед полным производственным запуском.