APIMaster.ai

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.