Wprowadzenie
PixVerse V6 Wideo z referencji tworzy klip ze zdjęć, które wysyłasz: do 7 elementów w jednym żądaniu. PixVerse nazywa ten tryb Fusion. Każdy element ma nazwę, jedno zdjęcie i rolę: subject dla człowieka, zwierzęcia, przedmiotu lub produktu albo background dla miejsca lub otoczenia. Wpisz @name w prompcie tam, gdzie każdy element ma się pojawić. Klipy trwają od 1 do 15 sekund w 360p do 1080p, w ośmiu proporcjach. PixVerse sprawdza prompty i obrazy przed generowaniem; żądania, które odrzuci, kończą się błędem i nie są obciążane.
Wybierz tryb PixVerse V6 według materiału wyjściowego
| Co masz na starcie | Tryb |
|---|---|
| napisaną scenę | PixVerse V6 Tekst na wideo |
| pierwszą klatkę, a opcjonalnie ostatnią | PixVerse V6 Obraz na wideo |
| zdjęcia ludzi, przedmiotów lub miejsc do obsadzenia | PixVerse V6 Wideo z referencji (tutaj jesteś) |
| klip, który chcesz kontynuować | PixVerse V6 Przedłużanie wideo |
| prompt lub jeden obraz i wyższą jakość obrazu | PixVerse V6 Max |
| jedno zdjęcie i gotowy szablon z motywem, bez pisania promptu | PixVerse V6 Effects |
Najważniejsze funkcje
Nazwij swoje elementy
Każdy element dostaje nazwę od 1 do 30 znaków i wywołujesz go w prompcie za pomocą @name. W naszym teście maya (zdjęcie rudowłosej kobiety w musztardowej kurtce) i trailer (zdjęcie chromowanej przyczepy kempingowej) stały się ujęciem o zmierzchu: kobieta idzie w stronę kamery z parującym emaliowanym kubkiem przed przyczepą, a lampki sznurowe są zapalone. Jej twarz, włosy i kurtka zgadzały się z referencją, tak samo przyczepa.
Zostaw spację po nazwie
W naszym teście "@trailer," z przecinkiem zaraz po nazwie zostało odrzucone, bo nazwa nie pasowała, a "@trailer and" zadziałało. Nieudane żądania nie są obciążane. Pisz @name, a po nim spację.
Podmioty i tła
Ustaw role na subject (domyślnie) dla ludzi, zwierząt, przedmiotów i produktów albo na background dla miejsca. Jedno żądanie może mieszać do 7 takich elementów.
Drobne artefakty się zdarzają
W naszej próbce na jednej klatce na chwilę pojawiła się w drzwiach druga postać. Sprawdź klip, zanim go opublikujesz.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Wymagany, od 3 do 5000 znaków. Wpisz @name tam, gdzie ma się pojawić każdy element, ze spacją po nim: w naszym teście "@trailer," zostało odrzucone, a "@trailer and" zadziałało. od 3 znaków · do 5000 znaków |
elements | Tak | Wymagane, od 1 do 7 pozycji. od 1 elementów · do 7 elementów |
aspect_ratio | Nie | 16:9 (domyślnie), 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 lub 21:9. Nie zmienia ceny. |
resolution | Nie | 360p, 540p, 720p (domyślnie) lub 1080p. Wyższe rozdzielczości kosztują więcej za sekundę. |
duration_seconds | Nie | Pełne sekundy od 1 do 15 (domyślnie 5). Cena jest za sekundę. |
generate_audio | Nie | Domyślnie wyłączony. Włączony generuje dźwięk razem z obrazem: atmosferę, efekty, muzykę i dialogi w cudzysłowie. Domyślnie: |
seed | Nie | Opcjonalna liczba całkowita od 0 do 2147483647. Przydatna do porównywania jednej zmiany naraz; nie gwarantuje identycznych klatek. |
Cennik
Rozliczane za sekundę wyniku. Rozdzielczość i przełącznik dźwięku zmieniają cenę za sekundę; proporcje i seed nie. Nieudane lub odrzucone żądania nie są obciążane.
| Rozdzielczość | Generuj dźwięk: Nie | Generuj dźwięk: Tak |
|---|---|---|
| $0.0222 / sekundę | $0.0311 / sekundę |
| $0.0311 / sekundę | $0.04 / sekundę |
| $0.04 / sekundę | $0.0533 / sekundę |
| $0.08 / sekundę | $0.1022 / sekundę |
Zastosowania
Umieść osobę w miejscu, w którym nigdy nie była sfotografowana
Portret jako jeden element i zdjęcie lokalizacji jako tło, z akcją opisaną w prompcie.
Zachowaj spójność pojazdu lub produktu
Daj samochodowi, przyczepie lub produktowi osobny element, by wyglądał jak na zdjęciu w każdym klipie.
Obsadź krótką scenę
Nazwij dwa lub trzy elementy, opisz, jak się spotykają, i dodaj ruch kamery.
Wskazówki
Zacznij od akcji, elementy nazywaj po drodze
Nasz prompt zaczyna się tak: "At blue hour in the high desert, @maya steps out of the door of @trailer and stretches, then walks toward the camera..." Każde @name stoi tam, gdzie ten element pojawia się w historii.
Jedno wyraźne zdjęcie na element
Każdy element to jedno zdjęcie jednego podmiotu lub miejsca. Nazwy powinny być krótkie i różne, na przykład maya i trailer.
Porównuj z seedem
seed pozwala porównywać przebiegi, gdy zmieniasz jedną rzecz naraz. Nie gwarantuje identycznych klatek.
Szybki start z 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": "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"
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.
