Introduction
Astra s’adresse aux plans dont l’apparence peut évoluer pendant l’agrandissement. Un intérieur créé par IA ou une séquence stylisée peut gagner des matériaux inventés ; on valide alors une interprétation visuelle plutôt qu’une récupération documentaire.
Fonctionnalités et points forts
Trois degrés de créativité et une description facultative règlent la liberté du modèle. Les livraisons comprennent 720p, 1080p et 4K, sans palier 2K.
La cave en low sans prompt a gagné des cheveux et des bords de verre, tout en modifiant œil et profil. Les trois secondes en 1080p ont pris environ 210 secondes ; même le niveau sobre peut changer un visage.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
video_url | Oui | Envoyez un MP4 par lien ou transfert de 1–60 secondes. Une durée plus courte ou longue est rejetée avant acceptation ; la version créative garde temps de lecture et audio. 1 caractères minimum |
prompt | Non | Texte facultatif décrivant la scène visible ou le rendu recherché ; vide, il laisse l’image guider l’interprétation. Ajouter une description ne modifie pas le tarif. 2000 caractères maximum |
resolution | Non | Sorties |
creativity_level | Non |
|
Tarification
Chez Astra, le niveau de sortie fixe tarif et durée du pas ; prompt et créativité ne changent pas le prix. Le temps source passe à la seconde puis au pas entier supérieurs, avec un minimum d’un pas. L’affichage à la seconde divise le prix du pas par sa longueur. L’envoi connu ou 60 secondes d’un lien sont réservés, l’excédent est restitué à la fin et un échec ne coûte rien. 720p et 1080p ont le même tarif, 4K un tarif plus élevé.
| Spécification | Prix |
|---|---|
| $0.36 / seconde |
| $0.36 / seconde |
| $0.60 / seconde |
Cas d’utilisation
Pour un insert stylisé, comparez tissus et verre avec la direction artistique et les plans qui l’entourent.
Pour terminer une vidéo IA, validez personnes et objets importants avant de demander plusieurs tailles de livraison.
Guide de prompt et conseils pratiques
Créez d’abord une version low sans texte. Si nécessaire, décrivez matériaux et lumière visibles dans une phrase cohérente et ne changez qu’un réglage par essai.
Relisez rotations de tête et textures mobiles avant d’approuver le rendu. Choisissez ensuite la taille finale et vérifiez que la bande-son a bien été conservée.
Démarrage rapide de l’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"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
