Wprowadzenie
Co robi ten endpoint
Przyjmuje jeden klip wideo i zwraca ten sam klip na wyższym poziomie rozdzielczości. Długość, proporcje, ruch, cięcia i ścieżka dźwiękowa zostają takie, jak je wysłano, a promptu nie ma.
Ważne dane wejściowe
video_url to klip o długości od 3 do 60 sekund, podany jako bezpośredni link do pliku. resolution wybiera poziom wyjścia: 720p, 1080p (domyślnie), 2k albo 4k. Poziom to budżet pikseli, więc klip 832×480 wraca przy 1080p w rozmiarze 1896×1094.
Co dostajesz
Jeden plik MP4 na żądanie, tej samej długości co oryginał, udostępniany z magazynu platformy po zakończeniu zadania.
| Pole | Wartość |
|---|---|
| Wejście | Wideo |
| Wyjście | Wideo |
| Endpoint | Upscale |
| Poziomy | 720p, 1080p, 2K, 4K |
| Rozliczenie | Za sekundę klipu źródłowego, zaokrąglane w górę, minimum 3 sekundy |
| Ustawienia | Bez promptu — tylko resolution |
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
video_url | Tak | Klip do powiększenia, od 3 do 60 sekund. od 1 znaków |
resolution | Nie | 720p, 1080p (domyślnie), 2k albo 4k — budżet pikseli z zachowaniem proporcji klipu, więc klip 832×480 w 1080p wraca w rozmiarze 1896×1094. |
Cennik
Rozliczenie za sekundę klipu źródłowego, z zaokrągleniem w górę do pełnej sekundy i minimum 3 sekund; stawkę za sekundę wyznacza poziom wyjścia. Szacunek przed wysłaniem przyjmuje długość przesłanego klipu plus jedną sekundę albo, dla adresu URL wideo, maksimum 60 sekund, a różnica zostaje zwolniona przy rozliczeniu.
| Specyfikacja | Cena |
|---|---|
| $0.006 / sekundę |
| $0.006 / sekundę |
| $0.012 / sekundę |
| $0.024 / sekundę |
Zastosowania
Szkice w 480p w jakości do oddania
Generuj tanio w 480p albo 720p, zostaw udane ujęcie i powiększ tylko je, zamiast płacić za każdą próbę w wysokiej rozdzielczości.
Wersje do social mediów i reklam
Podnieś krótkie klipy do rozdzielczości, jakiej oczekuje feed, landing page albo miejsce reklamowe, ze ścieżką dźwiękową na swoim miejscu.
Starsze nagrania na dużych ekranach
Nadaj małym klipom archiwalnym albo nagraniom ekranu czystszy, większy obraz do prezentacji i dużych wyświetlaczy.
Wskazówki
Najpierw montaż, potem upscaling
Powiększ wersję finalną. Inaczej każdy kolejny krok musiałby obrabiać kilka razy więcej pikseli.
Wyślij
video_urli resolutionvideo_urlto klip o długości od 3 do 60 sekund; resolution wybiera 720p, 1080p (domyślnie), 2k albo 4k. Nic więcej nie trzeba ustawiać.Odpytaj, a potem pobierz
Wywołanie jest asynchroniczne: utwórz zadanie, odpytuj je do końca i pobierz MP4 z magazynu platformy. 5-sekundowy klip w 4K ma około 19 MB.
Wprowadzenie
Video Upscaler przyjmuje gotowy klip i zwraca go na wyższym poziomie rozdzielczości. To przebieg zwiększania rozdzielczości, a nie edytor: kadr, ruch, cięcia, timing i oryginalna ścieżka dźwiękowa zostają takie, jak je wysłano. Promptu nie ma.
Żądanie
{
"video_url": "https://example.com/clip.mp4",
"resolution": "1080p"
}
Wymagany jest tylko video_url. Domyślnie resolution to 1080p; pozostałe poziomy to 720p, 2k i 4k.
Długość klipu i rozliczenie
Klip musi trwać od 3 do 60 sekund. Jeśli długość jest znana przy przyjęciu, klip spoza zakresu zostaje od razu odrzucony; w przeciwnym razie jest sprawdzana przed rozpoczęciem przetwarzania, a zadanie kończy się błędem z pełnym zwrotem. Rozliczenie następuje za sekundę klipu źródłowego, z zaokrągleniem w górę do pełnej sekundy i minimum 3 sekund, według stawki wybranego poziomu. Szacunek przed wysłaniem przyjmuje długość przesłanego klipu plus jedną sekundę albo, dla adresu URL wideo, maksimum 60 sekund; niewykorzystana część blokady zostaje zwolniona przy rozliczeniu.
Co wraca
Poziom to budżet pikseli, a proporcje zostają zachowane. Klip 832×480 wrócił w rozmiarze 1896×1094 przy 1080p po około 33 sekundach przetwarzania, a przy 4k w rozmiarze 3792×2188 po około 103 sekundach; 5-sekundowy MP4 w 4k ma około 19 MB. Klip 854×480 ze ścieżką AAC wrócił w rozmiarze 1922×1080 z tą samą ścieżką. W każdym teście długość zgadzała się z oryginałem co do klatki.
Przebieg zadania
Wywołanie jest asynchroniczne. Utwórz zadanie, odpytuj je do stanu końcowego, a potem pobierz MP4 z magazynu platformy.
Wskazówki
- Powiększ finalny montaż, po wszystkich edycjach.
- Wybierz poziom powyżej obecnej rozdzielczości klipu.
- Użyj bezpośredniego linku do pliku wideo. Strona, która odtwarza wideo, zwraca HTML, długości nie da się odczytać i wywołanie kończy się błędem ze zwrotem; najpewniej jest przesłać plik.
- Zacznij od najczystszego oryginału: bloki kompresji i szum też są powiększane.
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/video-upscaler-v1/upscale",
"input": {
"resolution": "1080p",
"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.
