Введение
3D to Video превращает черновую 3D-анимацию в кадр с готовым оформлением. Вместо ожидания, что генерация видео по тексту угадает нужный ракурс, вы задаёте движение в 3D-инструменте, рендерите серую сцену и передаёте модели уже оформленный кадр для её обработки. Результат сохраняет ваш тайминг и композицию, а цвет, свет и материалы получает из этого кадра.
Ключевые возможности и особенности
Движение задаёт черновая сцена
Наш серый 3-секундный клип с идущим игрушечным космонавтом и медленным облётом камеры вернулся длиной 3,0 секунды при 24 fps. Каждый шаг и дуга камеры сохранились по черновику. Длина результата всегда равна длине исходного видео, вплоть до двух минут.
Один оформленный кадр задаёт стиль
Мы превратили первый кадр черновика в марсианскую равнину в золотой час, и весь клип получил это оформление: пыльная красная почва, невысокие столовые горы, тёплый контровой свет и длинные тени. Оформленный последний кадр в last_image_url помог 4-секундной версии сохранить единый вид до конца.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
video_url | Да | Черновик: рендер 3D-сцены с серыми материалами в MP4 или WebM до 120 секунд; лучше всего подходит 24 fps. Задаёт камеру, движения, тайминг и пропорции. Не менее 1 символов |
image_url | Да | Оформление: первый кадр черновика, обработанный моделью для изображений (цвет, свет, материалы, окружение). Не отправляйте сам серый кадр. Не менее 1 символов |
last_image_url | Нет | Необязательно. Последний кадр черновика, оформленный в том же стиле, помогает удержать оформление в планах длиннее примерно трёх секунд. Не менее 1 символов |
prompt | Да | Одно-два предложения о готовом кадре, согласованные с изображением оформления. Не упоминайте серые материалы, 3D и черновую сцену. Не менее 1 символов · Не более 2000 символов |
resolution | Нет | 720p или 1080p (по умолчанию). Пропорции черновика сохраняются. |
seed | Нет | Необязательное целое число для повторения результата. На цену не влияет. |
Стоимость
Оплата за секунду чернового видео с округлением вверх, минимум за 3 и максимум за 120 секунд. Посекундный тариф зависит от resolution: 1080p стоит дороже 720p. Оформление последнего кадра, prompt и seed на цену не влияют. Неудачные запуски не оплачиваются.
| Спецификация | Стоимость |
|---|---|
| $0.048 / секунду |
| $0.12 / секунду |
Сценарии использования
От превизуализации к презентации идеи
Наметьте сцену простыми моделями-заглушками и нужным движением камеры, затем получите оформленный клип для презентации, обсуждения раскадровки или тизера в соцсетях. До одобрения идеи не придётся создавать материалы, схемы освещения и полноценное окружение.
Одна анимация в разных декорациях
Сохраните один черновик, меняя только изображение с оформлением и описание. Один и тот же идущий персонаж или вращающийся продукт сможет появиться в лесу, ночном неоновом городе или рисованном мультяшном мире. Одинаковый тайминг во всех версиях позволит монтировать их вместе.
Руководство по промптам и практические советы
Тщательно подготовьте изображение с оформлением
Экспортируйте самый первый кадр именно того черновика, который отправляете, и обработайте его любой моделью для изображений. Сохраните позу, композицию и положение горизонта. Чем точнее изображение совпадает с черновиком, тем чище края и стабильнее результат. Не загружайте исходный серый кадр без обработки: видео останется серым.
Пишите коротко и описывайте видимое
Опишите готовую сцену простыми словами в одном-двух предложениях, например "A small astronaut in a white spacesuit walks across a dusty red Martian plain at golden hour while the camera slowly circles." Пишите о том, что видит зритель, не упоминая серые материалы, серые модели, 3D и сам черновик.
Разбивайте длинные сцены на части
Для планов длиннее примерно трёх секунд оформите также последний кадр черновика и передайте его в last_image_url. Планы длиннее двух минут нужно разделить. Обрабатывайте каждую часть отдельно с теми же изображениями оформления и seed, чтобы части сочетались.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/3d-to-video-v1/video-edit",
"input": {
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "1080p",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.