Wprowadzenie
Video Character Swap Analysis czyta ujęcie i zwraca po jednej klatce podglądu na każdą osobę, którą potrafi poprowadzić, w stałej kolejności: pierwszy obraz to pozycja 0, drugi to pozycja 1, i tak dalej. To właśnie te pozycje przyjmuje wywołanie wymiany: oglądasz obrazy i odsyłasz numery.
Nic tu nie powstaje, a ujęcie pozostaje nietknięte. To wywołanie tworzy listę celów, na której pracuje wywołanie wymiany, i jest jedynym sposobem, żeby się dowiedzieć, ile osób jest w ujęciu i która jest która.
Najważniejsze funkcje
Wybierasz z obrazów, nie ze współrzędnych
Większość endpointów wymiany każe opisywać, o kogo ci chodzi, albo zgaduje. Tutaj analiza podaje kandydatów w postaci ponumerowanych obrazów. Wątpliwość co do tego, kto zostanie wymieniony, znika, zanim cokolwiek powstanie – czyli w momencie, w którym pomyłka jeszcze nic nie kosztuje.
Jedna analiza obsługuje kilka wymian
Wynik pozostaje użyteczny przez 24 godziny. Obsadź jedną osobę, obejrzyj wynik, a potem wyślij inny zestaw zdjęć referencyjnych do tej samej analizy – za analizę płacisz raz. Po 24 godzinach referencje wygasają i ujęcie trzeba przeanalizować od nowa.
Czyta materiał takim, jaki został nakręcony
Śledzenie prowadzi każdą osobę przez cięcia, obroty i częściowe zasłonięcia. Przyjmowane są ujęcia od 5 do 30 sekund, a analiza zgłasza każdą osobę, którą potrafi utrzymać przez całą długość ujęcia, nie tylko tę z pierwszego planu.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
video_url | Tak | Ujęcie do analizy, od 5 do 30 sekund. Zachowaj dokładnie ten adres: wywołanie wymiany musi działać na tym samym wideo i przepisuje go stąd automatycznie, jeśli tam go pominiesz. od 1 znaków |
resolution | Nie | Rozdzielczość śledzenia. Wywołanie wymiany musi użyć tej samej wartości, więc wybierz rozdzielczość, którą ma mieć gotowe ujęcie. |
Cennik
$0.08 / analiza
Analiza i podmiana są rozliczane osobno.
Zastosowania
Sprawdź ujęcie, zanim zapłacisz za wymianę
Wywołanie wymiany kosztuje więcej niż analiza. Wcześniejsza analiza mówi ci, czy osoby, na których ci zależy, rzeczywiście dają się śledzić w tym materiale: mocne rozmycie, długie zasłonięcia i postacie wychodzące poza kadr widać jako brakujący albo niestabilny podgląd.
Wskaż jedną osobę w tłumie
Przeanalizuj scenę, w której w kadrze jest kilka osób, przeczytaj podglądy i odeślij tylko tę pozycję, o którą ci chodziło. Wymiana nie rusza żadnej z pozostałych.
Utrzymaj tę samą obsadę w całej serii
Wygeneruj partię ujęć dowolnym modelem wideo, przeanalizuj każde z nich i na podstawie podglądów ustaw ten sam cel w każdym ujęciu, żeby seria czytała się jako całość.
Dowolna tematyka, za zgodą wykonawcy
Niezależnie od tego, co pokazuje materiał, w żądaniu nic się nie zmienia. Nie zmienia się też wymóg autoryzacji z ograniczeń poniżej: to twardy warunek, a nie klasyfikacja treści.
Wskazówki
Użyj tej samej rozdzielczości w obu wywołaniach
Wybierz rozdzielczość, którą ma mieć gotowe ujęcie, i ustaw ją także tutaj: wywołanie wymiany musi działać na tej samej wartości. Nie zmienia ona tego, co wykrywa to wywołanie, a tylko kadr, w którym pracuje wymiana.
Odczytaj kolejność podglądów, nie zakładaj jej
Obrazy wracają uporządkowane, ale kolejność bierze się ze śledzenia, a nie z miejsca na ekranie ani z tego, kto jest najbardziej widoczny. Osoba stojąca najbardziej po lewej nie musi być pozycją 0. Obejrzyj obrazy.
Wyślij to samo wideo do obu wywołań
Wywołanie wymiany potrzebuje identycznego ujęcia: tego samego pliku, tego samego kodowania. Pomiń video_url w żądaniu wymiany, a adres zostanie przepisany z analizy – to najpewniejszy sposób, żeby oba na pewno się zgadzały.
Przeanalizuj ponownie, jeśli materiał się zmienił
Ponowne kodowanie, przycięcie albo ponowny eksport unieważniają analizę: pozycje nie wskazują już tych samych osób. Przeanalizuj ten plik, który naprawdę pójdzie do wymiany.
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": "spicyapi/character-swap-v1/video-analyze",
"input": {
"resolution": "720p",
"video_url": "https://example.com/reference.mp4"
}
}'
# 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.