PixVerse V6.0 / C1 · Dokumentacja API
Generuj filmy PixVerse z tekstu, obrazów, klatek startowych i końcowych lub odniesień.
Jako model ID należy stosować pixverse-video-v6.0 lub pixverse-video-c1. Prześlij JSON za pomocą klawisza APIMaster w nagłówku Authorization: Bearer.
| Operacja | Punkt końcowy |
|---|---|
| Text-to-video | POST /v1/wand/pixverse/text-to-video |
| Image-to-video | POST /v1/wand/pixverse/image-to-video |
| Ramki startowe / końcowe | POST /v1/wand/pixverse/start-end-to-video |
| Reference-to-video | POST /v1/wand/pixverse/reference-to-video |
| Status zadania | GET /v1/wand/pixverse/tasks/{task_id} |
| Pole | Typ | Opis |
|---|---|---|
model |
string | Wymagane. Użyj jednej z powyższych identyfikatorów modelu. |
prompt |
string | Wymagane, do znaków 5,000. Promby referencyjne mogą być używane przez @ref_name. |
duration |
integer | 1–15 sekund, w tym w 1080p. Domyślnie jest to 5 sekund. |
quality |
string | Wymagane. 360p, 540p, 720p lub 1080p. |
aspect_ratio |
string | Text-to-video oraz reference-to-video Tylko. 16:9 (domyślnie), 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 lub 21:9. Inne trasy podążają za obrazem wejściowym. |
seed |
integer | Od 0 do 2,147,483,647. Pomiń pole lub ustaw 0, aby użyć losowego ziarna. |
generate_audio_switch |
boolean | Ustaw true na dźwięk. Wartość domyślna: false. |
camera_movement |
string | Opcjonalny ruch, taki jak zoom_in, dla text-to-video i image-to-video. |
generate_multi_clip_switch |
boolean | Opcjonalne dla V6.0 text-to-video i image-to-video. Wartość domyślna: false. |
img_id |
string | Wymagane dla image-to-video. Wizerunek publiczny URL lub Base64. |
img_ids |
string[] | Przeznaczony na image-to-video szablon multiimage. image-to-video wymaga img_id. |
first_frame_img, last_frame_img |
string | Wymagane dla wniosków o start / end-frame. Użyj publicznie URLs lub Base64. Użyj dopasowujących współczynników. |
image_references |
object[] | Wymagane dla reference-to-video. Do siedmiu pozycji z img_id, opcjonalnie type (subject lub background) i ref_name do znaków 30. |
curl -X POST "https://apimaster.ai/v1/wand/pixverse/text-to-video" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"pixverse-video-v6.0","prompt":"A slow pan across a mountain lake","duration":5,"quality":"720p"}'
Wymagane ErrCode=0, jak również udany status HTTP. Odpowiedź zawiera ErrMsg, Resp.video_id i request_id. Sondaż 3–5 sekundy z tym samym kontem. Resp.status to 1 dla sukcesu, 5 dla przetwarzania, 6 dla usunięcia, 7 dla awarii przeglądu zawartości oraz 8 dla awarii generacji. Resp.url jest końcowym pobraniem czasowym URL i trwa do 12 godzin. Reakcja może również obejmować wymiary, rozmiar, ziarno, styl i znaczniki czasu.
Sprawdzenie stanu nie uruchamia ponownego generowania ani nie nalicza kolejnej opłaty. Użyj Idempotency-Key z 8–128 widoczne ASCII znaki do odzyskania złożenia. Ten sam klucz i te same parametry zwracają potwierdzenie odzyskania z kodem HTTP 202. Ten sam klucz z innymi parametrami zwraca HTTP 409. Zob. Przewodnik odzyskiwania żądań. API nie akceptuje ujemnego parametru short lub callback_url.
tokenhub_usage.total_tokens raportuje billable use. Rozdzielczość i ustawienia audio wpływają na cenę. Patrz PixVerse V6.0 oraz Pixverse C1 karty modelowe dla bieżącego APIMaster ceny.
