Wprowadzenie
Astra służy ujęciom, których wygląd może ewoluować podczas powiększania. Wnętrze stworzone przez AI lub stylizowana sekwencja mogą zyskać wymyślone materiały; zatwierdza się więc interpretację wizualną, nie odzyskanie dokumentu.
Najważniejsze funkcje
Trzy poziomy kreatywności i opcjonalny opis regulują swobodę modelu. Dostępne wydania obejmują 720p, 1080p i 4K, bez szczebla 2K.
Piwnica z low bez promptu zyskała włosy i krawędzie szkła, lecz zmieniła też oko oraz profil. Trzy sekundy w 1080p zajęły około 210 sekund; nawet niski poziom może zmienić twarz.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
video_url | Tak | Prześlij MP4 przez odnośnik albo upload o długości 1–60 sekund. Krótsze i dłuższe materiały odrzuca się przed akceptacją; wersja kreatywna zachowuje czas i audio. od 1 znaków |
prompt | Nie | Opcjonalny tekst o widocznej scenie lub oczekiwanym wykończeniu; pusty pozostawia interpretację obrazowi. Dodanie opisu nie zmienia stawki. do 2000 znaków |
resolution | Nie | Wyjście |
creativity_level | Nie | Domyślne |
Cennik
W Astra poziom wyjścia ustala stawkę i długość kroku; prompt i kreatywność nie zmieniają ceny. Czas źródła zaokrągla się do kolejnej sekundy, potem pełnego kroku, minimum jednego. Wartość sekundowa dzieli cenę kroku przez jego długość. Rezerwuje się znany upload albo 60 sekund odnośnika, oddaje nadwyżkę po ukończeniu, a błędy są bezpłatne. 720p i 1080p mają tę samą stawkę, 4K wyższą.
| Specyfikacja | Cena |
|---|---|
| $0.36 / sekundę |
| $0.36 / sekundę |
| $0.60 / sekundę |
Zastosowania
W stylizowanej wstawce porównaj tkaniny i szkło z kierunkiem artystycznym oraz otaczającymi ujęciami.
Przy wykańczaniu wideo AI zatwierdź ważne postacie i przedmioty przed zamówieniem kilku rozmiarów wyjścia.
Wskazówki
Najpierw utwórz wersję low bez tekstu. W razie potrzeby opisz widoczne materiały i światło spójnym zdaniem, zmieniając jeden parametr na próbę.
Odtwórz obroty głowy i ruchome faktury przed akceptacją wyglądu. Następnie wybierz rozmiar końcowy i sprawdź zachowanie ścieżki dźwiękowej.
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": "topaz/astra/upscale",
"input": {
"creativity_level": "low",
"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.
