Популярные модели
Генерация видео обычно занимает больше времени, чем генерация изображений. Будьте готовы к более длительной обработке в зависимости от длительности и настроек качества видео.
Шаг 1: Сгенерируйте видео
Отправьте POST-запрос на /generate/video/kling/kling-2.5 с вашим запросом и параметрами видео. API сразу вернёт ID задания.
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";
const krea = new Krea({ apiKey: process.env.KREA_API_KEY });
const job = await krea.video("kling/kling-2.5", {
prompt: "a majestic eagle soaring over snow-capped mountains at sunrise",
duration: 5,
aspect_ratio: "16:9"
});
console.log(`Job ID: ${job.job_id}`);
Замените плейсхолдер на свой API-токенЧтобы заменить плейсхолдер YOUR_API_TOKEN в примерах выше, вам нужно сгенерировать API-токен на krea.ai/settings/api-tokens. Если понадобится помощь, следуйте инструкциям на странице API-ключи и биллинг.
Пример ответа
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "queued",
"created_at": "2025-01-15T10:30:00.000Z",
"estimated_time": "60-120 seconds"
}
Шаг 2: Опрос результата
Генерация видео занимает больше времени, чем генерация изображений. Опрашивайте /jobs/{job_id} каждые 5 секунд, чтобы проверять прогресс.
Доступны webhooks!Настройте webhooks, чтобы получать уведомления о завершении заданий. Начните с руководства по Webhooks.
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";
const krea = new Krea({ apiKey: process.env.KREA_API_KEY });
async function waitForVideo(jobId) {
const completed = await krea.jobs.wait(jobId, { intervalMs: 5000 });
return completed.result.urls[0];
}
const videoUrl = await waitForVideo(job.job_id);
console.log(`Video ready: ${videoUrl}`);
Пример завершённого ответа
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "completed",
"created_at": "2025-01-15T10:30:00.000Z",
"completed_at": "2025-01-15T10:31:45.000Z",
"result": {
"urls": ["https://gen.krea.ai/videos/your-video.mp4"]
}
}
Доступны webhooks!Настройте webhooks, чтобы получать уведомления о завершении заданий. Начните с руководства по Webhooks.
Общие параметры
Подробные параметры всех моделей см. на странице Model APIs.
| Параметр | Тип | Описание |
|---|
prompt | string | Детальное описание содержимого видео |
duration | number | Длина видео в секундах. Поддерживаемые значения зависят от модели. |
aspect_ratio | string | Соотношение сторон видео, например 16:9, 9:16 или 1:1 |
start_image | string | Необязательный URL исходного изображения для моделей image-to-video |
end_image | string | Необязательный URL финального кадра для поддерживаемых моделей |
mode | string | Необязательный режим качества для моделей, которые его поддерживают |
model | string | Модель генерации видео |
Советы по запросам для лучших видео:
- Конкретизируйте движение и работу камеры
- Описывайте сцену, освещение и атмосферу
- Указывайте темп (например, «медленный панорамный проезд», «быстрый зум»)
- Добавляйте стилевые референсы (например, «кинематографично», «в стиле документального кино»)
Генерация видео стоит дороже, чем генерация изображений. Цены по каждой модели и способы пополнения баланса API см. на странице API-ключи и биллинг.