Guide d’intégration
L’image vers vidéo retire la variable la plus difficile — à quoi ressemble la scène — et la remplace par une question plus étroite : comment elle doit bouger. L’image de référence fait l’essentiel du travail, et l’invite ne rattrape pas une référence faible.
L’enjeu
Les points d’accès de mouvement héritent de tout à partir de la première image : cadrage, lumière, rapport d’image, artefacts. Une référence floue ou mal recadrée donne un clip flou et mal recadré, au tarif vidéo.
01
Si la référence est en 1:1 et que vous demandez un clip en 16:9, le point d’accès doit ajouter des bandes, recadrer ou étirer. Alignez la référence sur l’aspect_ratio ou la resolution demandée avant l’envoi.
02
Là où last_image_url est déclaré, fournir les deux extrémités donne un début et une fin définis plutôt qu’une dérive ouverte. Là où il ne l’est pas, l’envoyer donne un 400.
03
movement_amplitude, camera_fixed, fps et duration_seconds apparaissent selon le point d’accès, et le schéma indique lesquels modifient le tarif. Il n’existe pas de vocabulaire de mouvement commun en dessous.
La méthode
Faites le travail d’image fixe sur un point d’accès image, où une itération coûte quelques centimes, figez l’image, puis payez le mouvement. Un téléversement spicy:// validé garde la référence identique octet pour octet entre deux essais : la reprise repart exactement des mêmes pixels.
Le corps est un appel de création avec un champ image. Le suivi est identique à celui de n’importe quelle tâche média.
POST /api/v1/jobs/createTask
POST /api/v1/jobs/createTask
Authorization: Bearer $SPICY_API_KEY
Idempotency-Key: 7b1f0c2e-9a4d-4f31-8c67-2b5e0d9a1c44
Content-Type: application/json
{
"model": "<publisher>/<model>/image-to-video",
"input": {
"prompt": "Slow push-in, fabric moving in a light breeze",
"image_url": "https://example.com/reference.png",
"duration_seconds": 5,
"resolution": "720p"
},
"callBackUrl": "https://example.com/hooks/spicyapi"
}202 Accepted
HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3
{
"code": 200,
"msg": "success",
"request_id": "req_example_create",
"data": {
"taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
"state": "queued",
"estimatedCost": "0.750000"
}
}Contrat
| Champ ou en-tête | Valeur ou limite |
|---|---|
| image_url · last_image_url | declared per endpoint |
| POST /api/v1/jobs/retry | new task · source record untouched |
| state | queued · running · succeeded · failed · expired |
| audio / video upload | ≤ 100 MiB · ≤ 600 s |
Balayez horizontalement pour voir toutes les colonnes.
Intégration
Pertinence
Vérifications
URL HTTPS, téléversements spicy:// validés et data URI intégrées fonctionnent de la même façon sur les points d’accès image et vidéo, sous les mêmes limites et les mêmes contrôles d’admission.
POST /api/v1/jobs/retry construit une tâche à partir d’une tâche échouée ou expirée et réévalue schéma, prix, droits et disponibilité. L’enregistrement source reste intact.
queued, running, succeeded, failed, expired. Les mêmes cinq mots décrivent chaque point d’accès média : la logique de transition s’écrit une fois.
Avant la mise en production
Questions fréquentes
Modèles
Chaque lien ouvre la page de la famille de modèles concernée : entrées, limites, politique de contenu et prix actuel à l’unité.
Et après
Transformez une image de référence en clip. Ce que la qualité de la première image, le rapport d’image, le mouvement et la durée changent.
