Solution API vidéo
La vidéo est le résultat le plus cher de la plupart des produits et le plus long à revenir. Trois champs du corps décident des deux, et la tâche continue bien après la disparition de la requête qui l’a lancée.
L’enjeu
Une requête vidéo n’est pas une requête d’image plus lente. La durée, la résolution et l’interrupteur audio fixent ce que vous payez et ce que vous attendez, avant même la première image.
01
La plupart des points d’accès vidéo facturent à la seconde produite dans la résolution choisie. Passer duration_seconds de 5 à 10 double à peu près la facture ; monter d’un cran en résolution recommence. Les deux sont marqués comme influant sur le prix dans le schéma : l’estimation va à côté du contrôle, pas sur la facture.
02
Là où generate_audio existe, ce booléen bascule la requête sur un autre tarif. Un formulaire qui le masque enverra discrètement la version la plus chère à chaque fois.
03
createTask répond 202 Accepted avec un taskId à l’état queued. La génération se poursuit côté serveur pendant plusieurs minutes. Tout code qui attend sur la connexion d’origine expirera pendant que la tâche, et la facture, continuent.
La méthode
Faites estimer le corps exact avec POST /api/v1/jobs/quote, affichez le montant, puis envoyez ce même corps à createTask avec quoteId, expectedCost et une clé Idempotency-Key conservée. Un prix qui a bougé entre les deux appels échoue avec le code métier 40901 plutôt que de surgir sur la facture.
Un appel de création transporte le modèle, l’entrée validée et un rappel facultatif. HTTP 202 signifie accepté, pas terminé.
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>/text-to-video",
"input": {
"prompt": "A slow aerial drift over a misty pine forest at sunrise",
"duration_seconds": 5,
"resolution": "1080p",
"generate_audio": true
},
"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 |
|---|---|
| POST /api/v1/jobs/createTask | 202 Accepted · state queued |
| duration_seconds · resolution · generate_audio | price-affecting fields |
| Idempotency-Key | 24 h · scoped to one API key |
| output.assets[].expiresAt | signed URL · results kept 14 days |
Balayez horizontalement pour voir toutes les colonnes.
Intégration
Pertinence
Vérifications
Le formulaire de chaque page modèle est généré depuis l’input_schema du point d’accès, et le serveur valide contre le même document. Un champ non déclaré renvoie 400 au lieu d’être ignoré.
createTask réserve le montant estimé et le renvoie dans cost avec settled: false. La facturation finale ne dépasse jamais la réservation ; un échec ou une expiration la libère intégralement.
Plafonnez une clé par jour, par mois et sur toute sa durée de vie, restreignez-la à certains modèles et adresses IP, et envoyez chaque écriture avec la même clé d’idempotence.
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
Comparez les points d’accès vidéo par durée, résolution, audio et prix, puis envoyez la même requête depuis votre serveur.
