PixVerse V6 API

PixVerse V6 Reference to video собирает клип из изображений, которые вы отправляете: до 7 элементов в одном запросе. PixVerse называет этот режим Fusion. У каждого элемента есть имя, одно изображение и роль: subject для человека, животного, предмета или продукта либо background для места или обстановки. Пишите @name в промпте там, где каждый элемент должен появиться. Клипы длятся от 1 до 15 секунд в 360p–1080p, в восьми соотношениях сторон. PixVerse проверяет промпты и изображения до генерации; запросы, которые он отклоняет, завершаются ошибкой и не оплачиваются.

Выберите режим PixVerse V6 по исходному материалу

Именуйте элементы

Дайте каждому элементу имя из 1–30 символов и вызывайте его через @name в промпте. В нашем тесте maya (фото рыжеволосой женщины в горчичной куртке) и trailer (фото хромированного дорожного трейлера) стали кадром в сумерках: она идёт к камере с дымящейся эмалированной кружкой перед трейлером, на котором горят гирлянды. Её лицо, волосы и куртка совпали с референсом, как и трейлер.

Пробел после имени

В нашем тесте "@trailer," с запятой сразу после имени была отклонена, потому что имя не совпало, а "@trailer and" сработала. Неудачные запросы не оплачиваются. Пишите @name и сразу за ним пробел.

Персонажи и фоны

Задайте role равным subject (по умолчанию) для людей, животных, предметов и продуктов или background для места. В одном запросе может быть до 7 элементов любого вида.

Небольшие артефакты случаются

В нашем примере на одном кадре на мгновение появлялась вторая фигура в дверях. Проверяйте клип перед публикацией.

Поставить человека туда, где его никогда не фотографировали

Портрет как один элемент и фото места как фон, а действие описано в промпте.

Сохранить автомобиль или продукт одинаковыми

Дайте автомобилю, трейлеру или продукту отдельный элемент, и он будет совпадать со своим фото в каждом клипе.

Собрать короткую сцену

Назовите два-три элемента, опишите, как они встречаются, и добавьте движение камеры.

# 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": "pixverse/v6/reference-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "elements": [
      {
        "name": "example",
        "image_url": "https://example.com/reference.png"
      }
    ],
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": false,
    "duration_seconds": 5
  }
}'

# 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.