Video
PixVerse V6
Generuj w PixVerse V6 klipy 1–15 sekund z tekstu, obrazu, dwóch klatek, obrazów referencyjnych lub wcześniejszego klipu, w rozdzielczości od 360p do 1080p, rozliczane za sekundę.
PixVerse V6 to model wideo od PixVerse. Jeden identyfikator modelu obejmuje pięć trybów: tekst na wideo, obraz na wideo, przejście między pierwszą a ostatnią klatką, wiele obrazów referencyjnych i przedłużanie wcześniej utworzonego klipu. Tryb wynika z wysłanych pól. Klipy trwają 1–15 sekund w rozdzielczości 360p, 540p, 720p lub 1080p, z opcjonalnym natywnym dźwiękiem. Wyślij żądanie, zachowaj zwrócony identyfikator zadania i odczytaj gotowe wideo z tego zadania. Obrazy przekazujesz jako adresy URL.
ID modeli
| ID modelu | Dane wejściowe | Rozdzielczości | Długość |
|---|---|---|---|
pixverse-v6 | tekst, jeden obraz, pierwsza + ostatnia klatka, 1–7 obrazów referencyjnych, zakończone zadanie pixverse-v6 | 360p, 540p, 720p, 1080p | 1–15 sekund |
Aktualne ceny znajdziesz na stronie modelu. Do jednego bardziej szczegółowego ujęcia z tekstu lub jednego obrazu zobacz PixVerse V6 Max.
Krótki przykład
curl https://api.seedrouter.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "pixverse-v6",
"prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
"resolution": "540p",
"duration": 5,
"size": "16:9"
}'Punkt końcowy
POST https://api.seedrouter.ai/v1/videos/generations| Nagłówek | Wartość |
|---|---|
| Authorization | Bearer YOUR_API_KEY |
| Content-Type | application/json |
Odpowiedź to zadanie ({"id": "task_...", "status": "processing"}), a nie gotowe wideo. Wynik odczytasz, odpytując GET /v1/tasks/{task_id}. Klucze API trzymaj w kodzie po stronie serwera.
Parametry
| Pole | Typ | Domyślnie | Uwagi |
|---|---|---|---|
model | string | wymagane | pixverse-v6 |
prompt | string | wymagane | Do 5 000 znaków. Wymagany w każdym trybie. |
resolution | enum | 540p | 360p, 540p, 720p lub 1080p. |
duration | integer | 5 | 1–15 sekund. Przejście między pierwszą a ostatnią klatką trwa tylko 5 lub 8. |
size | enum | 16:9 | 16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 lub 21:9. Używane przez tekst na wideo i wiele obrazów referencyjnych; pozostałe tryby przejmują format obrazów. |
audio | boolean | false | Generuj natywny dźwięk. Rozliczane po stawce za audio. |
seed | integer | brak | 0–2147483647. To samo żądanie i seed dają podobne wyniki. |
negative_prompt | string | brak | Czego nie umieszczać w klipie. Do 2 048 znaków. |
watermark | boolean | false | Dodaj znak wodny. |
motion_mode | enum | normal | Obsługiwane jest tylko normal. |
generate_multi_clip_switch | boolean | false | Generowanie multi-clip. Tylko tekst na wideo i obraz na wideo. |
image_urls | lista adresów URL | brak | Obraz na wideo. Używany jest pierwszy obraz. |
first_frame_image | URL | brak | Przejście: pierwsza klatka. Wyślij razem z last_frame_image. |
last_frame_image | URL | brak | Przejście: ostatnia klatka. Wyślij razem z first_frame_image. |
img_references | lista adresów URL | brak | Wiele obrazów referencyjnych: 1–7 obrazów. |
extend_from_task_id | string | brak | Przedłużanie: identyfikator jednego z Twoich zakończonych zadań pixverse-v6. |
Schemat jest ścisły: nieznane pola są odrzucane, a nie ignorowane. callback_url nie jest dostępne; zamiast tego odpytuj zadanie.
Tryby
Wysłane pola wybierają tryb. W jednym żądaniu wysyłaj pola jednego trybu.
| Tryb | Wyślij | Uwagi |
|---|---|---|
| Tekst na wideo | bez pól obrazu i przedłużania | size wyznacza format. |
| Obraz na wideo | image_urls | Klip zaczyna się od pierwszego obrazu. |
| Przejście | first_frame_image + last_frame_image | 5 lub 8 sekund. |
| Wiele obrazów referencyjnych | img_references (1–7 adresów URL) | Łączy postacie, obiekty lub sceny z obrazów; size wyznacza format. |
| Przedłużanie | extend_from_task_id | Kontynuuje Twoje zakończone zadanie pixverse-v6. |
{
"model": "pixverse-v6",
"prompt": "The puppy slowly turns into a kitten, soft studio light.",
"first_frame_image": "https://example.com/puppy.jpg",
"last_frame_image": "https://example.com/kitten.jpg",
"duration": 5
}{
"model": "pixverse-v6",
"prompt": "The paper boat drifts on toward a lily pad.",
"extend_from_task_id": "task_...",
"resolution": "540p",
"duration": 5
}Przedłużanie zwraca klip źródłowy z dodanym nowym fragmentem i nalicza tylko duration nowego fragmentu. W naszym teście przedłużenie 1-sekundowego klipu o 1 sekundę zwróciło wideo o długości 2,1 sekundy, rozliczone za 1 sekundę.
Dane wejściowe multimediów
Obrazy to publiczne adresy URL HTTP(S). Dane base64 (data URI) nie są przyjmowane: prześlij plik do własnego magazynu i przekaż jego adres URL. Użyj obrazów JPG, PNG lub WebP o rozmiarze do 20 MB.
Czynniki wpływające na koszt
Aktualne stawki znajdziesz w sekcji cen modelu. PixVerse V6 jest rozliczany za sekundę wideo według stawki zależnej od rozdzielczości i generowania dźwięku:
cost = duration × rate per second for the resolution and audio settingKażdy tryb kosztuje tyle samo za sekundę; przedłużanie nalicza tylko nowy fragment. Czas trwania jest znany w chwili przyjęcia żądania, więc zarezerwowana kwota jest kwotą naliczoną. Ostateczne opłaty zobaczysz w historii zużycia swojego konta. Nieudane zadania nie są naliczane.
Schemat odpowiedzi
Wysłanie zwraca zadanie:
{"id": "task_...", "model": "pixverse-v6", "status": "processing", "created_at": 1789689600}Pobieranie zadania
GET https://api.seedrouter.ai/v1/tasks/{task_id}Odpytuj co 10–20 sekund, aż status przyjmie wartość completed lub failed. Przekroczenie limitu czasu sieci podczas odpytywania nie oznacza, że generowanie się nie powiodło: zachowaj identyfikator zadania i wznów sprawdzanie. Nie twórz kolejnego zadania, aby sprawdzić postęp.
Zadanie zakończone
{
"id": "task_...",
"model": "pixverse-v6",
"status": "completed",
"created_at": 1789689600,
"finished_at": 1789689640,
"output": {
"video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
}
}W naszych testach 1-sekundowe klipy 360p 16:9 wracały jako MP4 (H.264) w rozdzielczości 640 × 360, po 36–45 sekundach od wysłania.
Błędy
Żądania odrzucone przed utworzeniem zadania zwracają błąd HTTP wraz z obiektem error i nie są naliczane. Zadanie, które zawiodło po przyjęciu, przy odpytaniu zwraca HTTP 200 z status: "failed" i obiektem error.
Kody, statusy HTTP i wskazówki dotyczące ponawiania znajdziesz we wspólnym katalogu błędów.
{
"id": "task_...",
"model": "pixverse-v6",
"status": "failed",
"error": {
"code": 60001,
"message": "The request was rejected by the content policy. Please revise the prompt or input images."
}
}Jeśli limit czasu został przekroczony przy samym wysyłaniu, przed ponownym wysłaniem sprawdź swoje zadania: pierwsze żądanie mogło już zostać przyjęte.
Wskazówki
- Opisz obiekt, miejsce, ruch kamery i światło w prompcie; wymień dźwięki, które chcesz uzyskać, gdy
audiojest włączone. - Przygotuj wersję roboczą w
360plub540p, a potem wyrenderuj finalne ujęcie w1080ptym samym żądaniem i z tym samymseed. - Aby uzyskać pionowe wideo, wyślij
size: "9:16"w trybie tekst na wideo albo pionowy obraz. - Dodaj
no text, no logos, aby w kadrze nie pojawiały się wymyślone oznaczenia.
