Introduction
Ce que fait cet endpoint
Il prend un clip vidéo et renvoie le même clip à un palier de résolution supérieur. La durée, le rapport d’aspect, le mouvement, les coupes et la piste audio restent tels qu’envoyés, et il n’y a pas de prompt.
Les entrées qui comptent
video_url est le clip, de 3 à 60 secondes, sous forme de lien direct vers le fichier. resolution choisit le palier de sortie : 720p, 1080p (par défaut), 2k ou 4k. Le palier est un budget de pixels : un clip de 832×480 revient donc en 1896×1094 en 1080p.
Ce que vous recevez
Un MP4 par requête, de la même durée que la source, servi depuis le stockage de la plateforme une fois la tâche terminée.
| Champ | Valeur |
|---|---|
| Entrée | Vidéo |
| Sortie | Vidéo |
| Endpoint | Upscale |
| Paliers | 720p, 1080p, 2K, 4K |
| Facturation | À la seconde du clip source, arrondie au-dessus, 3 secondes minimum |
| Réglages | Aucun prompt — resolution seulement |
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
video_url | Oui | Le clip à agrandir, de 3 à 60 secondes. 1 caractères minimum |
resolution | Non | 720p, 1080p (par défaut), 2k ou 4k — un budget de pixels avec le rapport d’aspect du clip conservé : un clip de 832×480 en 1080p revient donc en 1896×1094. |
Tarification
Facturé à la seconde du clip source, arrondie à la seconde entière supérieure avec un minimum de 3 secondes ; le palier de sortie fixe le tarif à la seconde. L’estimation avant envoi retient la durée d’un clip téléversé plus une seconde, ou le maximum de 60 secondes pour une URL vidéo, et la différence est libérée au règlement.
| Spécification | Prix |
|---|---|
| $0.006 / seconde |
| $0.006 / seconde |
| $0.012 / seconde |
| $0.024 / seconde |
Cas d’utilisation
Des brouillons 480p en qualité de livraison
Générez à petit prix en 480p ou 720p, gardez la prise réussie et n’agrandissez qu’elle, au lieu de payer chaque essai en haute résolution.
Formats sociaux et publicitaires
Portez des clips courts à la résolution qu’attendent un fil, une page d’atterrissage ou un emplacement publicitaire, avec la bande-son toujours en place.
Des images anciennes sur de grands écrans
Donnez à de petits clips d’archive ou à des enregistrements d’écran une image plus propre et plus grande pour les présentations et les grands affichages.
Guide de prompt et conseils pratiques
Finir le montage, puis agrandir
Agrandissez la version finale. Sinon, chaque étape suivante devrait traiter plusieurs fois plus de pixels.
Envoyer
video_urlet resolutionvideo_urlest le clip, de 3 à 60 secondes ; resolution choisit 720p, 1080p (par défaut), 2k ou 4k. Il n’y a rien d’autre à régler.Interroger, puis télécharger
L’appel est asynchrone : créez la tâche, interrogez-la jusqu’à la fin et récupérez le MP4 dans le stockage de la plateforme. Un clip de 5 secondes en 4K pèse environ 19 Mo.
Introduction
Video Upscaler prend un clip fini et le renvoie à un palier de résolution supérieur. C’est une passe de résolution, pas un outil de montage : le cadrage, le mouvement, les coupes, le rythme et la piste audio d’origine restent tels qu’envoyés. Il n’y a pas de prompt.
Requête
{
"video_url": "https://example.com/clip.mp4",
"resolution": "1080p"
}
Seul video_url est obligatoire. resolution vaut 1080p par défaut ; les autres paliers sont 720p, 2k et 4k.
Durée du clip et facturation
Le clip doit durer de 3 à 60 secondes. Si la durée est connue à l’acceptation, un clip hors de cette plage est refusé tout de suite ; sinon elle est vérifiée avant le début du traitement, et la tâche échoue avec un remboursement complet. La facturation se fait à la seconde du clip source, arrondie à la seconde entière supérieure avec un minimum de 3 secondes, au tarif du palier choisi. L’estimation avant envoi retient la durée d’un clip téléversé plus une seconde, ou le maximum de 60 secondes pour une URL vidéo ; la part non utilisée de la réserve est libérée au règlement.
Ce qui revient
Le palier est un budget de pixels et le rapport d’aspect est conservé. Un clip de 832×480 est revenu en 1896×1094 en 1080p après environ 33 secondes de traitement, et en 3792×2188 en 4k après environ 103 secondes ; un MP4 de 5 secondes en 4k pèse environ 19 Mo. Un clip de 854×480 avec une piste AAC est revenu en 1922×1080 avec la même piste. Dans chaque test, la durée correspondait à la source à l’image près.
Déroulement de la tâche
L’appel est asynchrone. Créez la tâche, interrogez-la jusqu’à un état final, puis téléchargez le MP4 depuis le stockage de la plateforme.
Conseils
- Agrandissez le montage final, après toutes les retouches.
- Choisissez un palier au-dessus de la résolution actuelle du clip.
- Utilisez un lien direct vers le fichier vidéo. Une page web qui lit la vidéo renvoie du HTML, la durée ne peut pas être lue et l’appel échoue avec remboursement ; téléverser le fichier est la voie la plus sûre.
- Partez de la source la plus propre possible : les blocs de compression et le bruit sont agrandis aussi.
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": "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"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
