API Veo 3.1

Полный справочник API для моделей генерации видео Veo 3.1.

Варианты модели

Этот API поддерживает четыре варианта модели:

Краткое сравнение

Veo 3.1 text-to-video (Standard & Fast)

Эндпоинт {#}

POST /api/v1/video/task

Параметры запроса

Обязательные

Необязательные

Пример запроса

Версия Standard:

javascriptКопировать
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'veo3.1-text-to-video',
    prompt: 'A time-lapse of a flower blooming'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Версия Fast:

javascriptКопировать
{
  model_name: 'veo3.1-fast-text-to-video',
  prompt: 'A time-lapse of a flower blooming'
}

Veo 3.1 image-to-video (Standard & Fast)

Параметры запроса

Обязательные

Необязательные

Пример запроса

Версия Standard:

javascriptКопировать
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'veo3.1-image-to-video',
    image_url: 'https://example.com/image.jpg',
    prompt: 'Camera slowly zooms in, soft wind movement'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Версия Fast:

javascriptКопировать
{
  model_name: 'veo3.1-fast-image-to-video',
  image_url: 'https://example.com/image.jpg',
  prompt: 'Camera slowly zooms in, soft wind movement'
}

Формат ответа

Начальный ответ

jsonКопировать
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Ответ опроса

Опрашивайте /api/v1/video/{taskId}, чтобы проверить статус:

jsonКопировать
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Значения статуса

• submitted: задача принята и ожидает обработки
• processing: генерация видео выполняется
• succeed: генерация видео завершена
• failed: генерация видео завершилась ошибкой

Время обработки

• Версия Standard: ~2-3 минуты
• Версия Fast: ~1-2 минуты

Используйте опрос для проверки статуса генерации каждые 5-10 секунд.

Рекомендации

• Точно описывайте движения камеры и динамику сцены
• Версия Fast дает хорошее качество при более быстрой обработке
• Версия Standard обеспечивает максимальное качество вывода
• Используйте описательные промпты для лучших результатов