Introduzione
Astra è pensato per riprese il cui aspetto può evolvere durante l’ingrandimento. Un interno creato con IA o una sequenza stilizzata può guadagnare materiali inventati; si approva quindi un’interpretazione visiva, non un recupero documentale.
Caratteristiche principali
Tre livelli di creatività e una descrizione facoltativa regolano la libertà del modello. Le consegne comprendono 720p, 1080p e 4K, senza gradino 2K.
La cantina low senza prompt ha guadagnato capelli e bordi di vetro, modificando però occhio e profilo. I tre secondi a 1080p hanno richiesto circa 210 secondi; anche il livello sobrio può cambiare un volto.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
video_url | Sì | Invia un MP4 tramite link o caricamento di 1–60 secondi. Una durata minore o maggiore viene rifiutata prima dell’accettazione; la versione creativa mantiene tempo e audio. almeno 1 caratteri |
prompt | No | Testo facoltativo sulla scena visibile o sul risultato desiderato; vuoto lascia che l’immagine guidi l’interpretazione. Aggiungere la descrizione non modifica la tariffa. al massimo 2000 caratteri |
resolution | No | Uscita |
creativity_level | No |
|
Prezzi
In Astra il livello di uscita fissa tariffa e durata del passo; prompt e creatività non cambiano il prezzo. Il tempo sorgente passa al secondo e poi al passo intero superiori, con minimo di uno. Il valore al secondo divide il prezzo del passo per la sua lunghezza. Si riserva il caricamento noto o 60 secondi di un link, si restituisce l’eccesso al termine e un errore non costa. 720p e 1080p hanno la stessa tariffa, 4K una maggiore.
| Specifiche | Prezzo |
|---|---|
| $0.36 / secondo |
| $0.36 / secondo |
| $0.60 / secondo |
Casi d’uso
Per un inserto stilizzato, confronta tessuti e vetro con la direzione artistica e con le riprese circostanti.
Per rifinire un video IA, approva persone e oggetti importanti prima di richiedere più formati di consegna.
Consigli avanzati
Crea prima una versione low senza testo. Se serve, descrivi materiali e luce visibili in una frase coerente, cambiando una sola impostazione per prova.
Riproduci rotazioni della testa e trame mobili prima di approvare il risultato. Scegli poi il formato finale e verifica che la colonna sonora sia stata conservata.
Avvio rapido dell’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"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
