Оживите свои изображения, сгенерировав высококачественную видеоанимацию.

Изображение в видео

Конечная точка Image to Video оживляет статические изображения, генерируя высококачественную видеоанимацию на основе текстового запроса.

Название модели: image-to-video

Жизненный цикл: экспериментальный

Время обработки: ~60–180 с

Формат вывода: MP4

Методы доставки: URL (через опрос статуса)

Кредиты: от 6 до 12 за видео (зависит от продолжительности)

Запрос

Сгенерируйте видео, отправив свое изображение и запрос на универсальную конечную точку /v1/run:

POSThttps://fititon.app/api/v1/run

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

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "image-to-video",
           "inputs": {
             "imageUrl": "https://example.com/product.jpg",
             "prompt": "Camera pans slowly around the model as she walks forward",
             "duration": 6,
             "aspectRatio": "9:16"
           }
         }'

Ответ

Поскольку генерация видео занимает несколько минут, конечная точка /v1/run немедленно возвращает статус 200 OK с асинхронным id задания. Вы должны опрашивать Status API, используя GET /v1/status/{id}, чтобы получить окончательный URL MP4. В качестве альтернативы вы можете настроить веб-хуки для автоматического получения уведомлений. Обратите внимание, что наш диспетчер веб-хуков применяет строгое 15-секундное ограничение по времени. Ваш сервер должен подтвердить веб-хук кодом состояния 2xx в течение 15 секунд, иначе мы будем считать его неудачным и повторим попытку позже.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

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

Обязательные параметры

imageUrlRequiredstring

Входное изображение для анимации. Может быть общедоступным URL или строкой изображения, закодированной в Base64.

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

Требование к форматированию При отправке строки Base64 она должна включать стандартный префикс URI данных (например, data:image/jpeg;base64,...).

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

promptstring

Текстовое описание, направляющее анимацию. Если опущено, ИИ будет выводить естественное движение из контекста изображения.

durationinteger

Длительность сгенерированного видео в секундах. Поддерживаемые значения: 4, 6, 8. По умолчанию: 6

aspectRatio'16:9' | '9:16'

Соотношение сторон выходного видео. По умолчанию: 9:16

generateAudioboolean

Генерировать ли контекстное AI-аудио для сопровождения видео. По умолчанию: true

Ошибки выполнения

Ошибки выполнения для этой функции используют общий набор, задокументированный в разделе Обработка ошибок. Если во время обработки возникает ошибка, status обновится до "error", а поле error будет содержать конкретную причину сбоя.

Стоимость кредитов

Для запросов Developer API стоимость полностью зависит от запрошенной duration видео.

Формула: Стоимость = DurationCredits

Длительность	Кредитов за видео
4с	6
6с (По умолчанию)	9
8с	12