Créez avec l’API V4V.
Générez des images, des vidéos et de l’audio depuis vos propres applications. Une clé API. Vos crédits V4V existants.
https://v4v.ai/api/v1curl https://v4v.ai/api/v1/models \
-H "Authorization: Bearer $V4V_API_KEY"Authentification
Créez une clé nommée dans Profil → Clés API. Enregistrez le secret API et le secret de signature webhook lorsqu’ils s’affichent ; ils ne sont affichés qu’une seule fois. Plusieurs clés peuvent être créées et révoquées indépendamment. Les secrets de clé sont stockés sous forme de hachages SHA-256.
Envoyez Authorization: Bearer v4v_live_… sur chaque requête API. Conservez cette clé sur votre serveur, hors des applications navigateur et du contrôle de source. La révocation bloque les futures requêtes ; les générations déjà acceptées se poursuivent.
URL de base : https://v4v.ai/api/v1.
Découvrir les modèles Lab
GET /models liste les ID actuels des modèles Lab, leur état d’activation, les entrées, paramètres, valeurs par défaut, conditions et limites. GET /models/{model} décrit un modèle. Les ID et schémas proviennent du même catalogue et des mêmes valeurs par défaut que ceux utilisés par Lab. La configuration Studio est distincte.
Les noms de modèle dans les exemples ci-dessous sont de véritables ID de catalogue. Utilisez discovery pour trouver les modèles actuellement activés sur votre compte. Les noms de champ sont spécifiques au modèle : conservez les noms renvoyés par discovery, y compris les noms en camelCase tels que aspectRatio ou referenceImageUrls. Les valeurs de sélection sont des chaînes ; les valeurs numériques pour des options de sélection d’apparence numérique sont également acceptées. Les champs peuvent être fournis dans input ou parameters, mais jamais dans les deux. Les champs inconnus sont rejetés. Les modèles avec versions sélectionnables exposent parameters.variant ; utilisez les valeurs et les valeurs par défaut renvoyées par discovery.
curl https://v4v.ai/api/v1/models \
-H "Authorization: Bearer $V4V_API_KEY"Sous-titres horodatés de la parole
Découvrez ai.speech_to_text avec le type subtitle. Envoyez un ID de fichier média détenu ou une URL prise en charge dans input.audioUrl ou input.videoUrl à POST /lab ; les paramètres facultatifs incluent language_code (par exemple uk, en ou auto) et diarize. L’estimation utilise la durée de la source d’origine. La transcription consomme les crédits habituels du compte.
Une tâche terminée renvoie results[].type: "subtitle", la transcription text, srt et des cues modifiables avec start, end en secondes et text. Une entrée silencieuse réussie peut avoir une liste de repères vide. Pour le montage, utilisez les outils MCP de Video Editor pour aligner ces repères sur le trim, la vitesse et la position dans la timeline d’un clip source.
Derniers modèles de génération disponibles
Omni Flash 1.2 (video.gemini_omni_flash-1-2) est le modèle préféré pour les requêtes vidéo sans modèle explicite. Le Laboratoire l’affiche en premier ; Omni Flash 1.1 reste disponible sous Plus et via son ID existant. Découvrez les paramètres actuels avec GET /models/{model}. La version 1.2 prend en charge la génération et l’édition de 3 à 15 secondes ; l’interpolation première/dernière image est limitée à 10 secondes. Les tarifs partagés 4/6/8/10 secondes correspondent aux prix 1.1 configurés. Utilisez discovery et les estimations actuelles pour les tarifs au lieu de stocker cette relation comme règle permanente.
Choisissez GPT Image 2.6 via parameters.variant dans image.text_to_image ou ai.image_edit. Utilisez parameters.outputFormat avec ces capacités de variante exactes :
| Variante | Formats de sortie |
|---|---|
gpt-image-2.6-flare-text | png, jpeg, webp, gif, svg |
gpt-image-2.6-sunburst-text | png, jpeg, webp, gif, svg |
gpt-image-2.6-flare-img | png, jpeg, webp |
gpt-image-2.6-sunburst-img | png, jpeg, webp |
gpt-image-2.6-economy-text | png, gif |
gpt-image-2.6-economy-img | png |
parameters_schema.outputFormat.allowed_by_variant fait autorité. Flare/Sunburst sont ajustés en fonction de l’utilisation réelle en entrée/sortie ; l’utilisation de conversion SVG est incluse dans le total final. Economy est disponible en 1K uniquement avec une tarification par image. Les téléchargements conservent les images de GIF et les octets vectoriels SVG ; les téléchargements SVG utilisent une livraison en pièce jointe.
Nano Banana 2.1 utilise parameters.variant: "nano-banana-v2.1" dans les mêmes modules d’image, avec jusqu’à 10 références et une sortie 1K/2K/4K. Son mode de facturation actuel est publié dans . La génération Google/Vertex est ajustée à partir des entrées vérifiées, des entrées mises en cache, de la sortie image, de la sortie texte et des tokens de réflexion, avec une majoration appliquée et le total combiné arrondi une seule fois à l’unité supérieure. Le composant de sortie image est d’environ 11/16/36 crédits V4V pour 1K/2K/4K avant l’entrée et la réflexion. Le Laboratoire et les estimations affichent une plage approximative ; la réservation initiale est distincte du coût final. Les autres routages utilisent le tarif par image configuré. Le routage reste géré par V4V ; ne fournissez pas de paramètre de routage.
Modèles vidéo Kling 4.0
Quatre nœuds distincts partagent la même gestion de génération et de résultat dans le Laboratoire, les Flux de travail, l'API et MCP :
| ID du catalogue | Modèle | Durée | Résolution |
|---|---|---|---|
video.kling_v40_ref | Kling 4.0 Reference | 3–30 secondes | 720p / 1080p |
video.kling_v40_key | Kling 4.0 Keyframe | 3–30 secondes | 720p / 1080p |
video.kling_v40_flash_ref | Kling 4.0 Flash Reference | 3–20 secondes | 720p |
video.kling_v40_flash_key | Kling 4.0 Flash Keyframe | 3–20 secondes | 720p |
Tous acceptent un prompt obligatoire (jusqu'à 8000 caractères), un duration entier, resolution et aspectRatio (auto, 16:9, 9:16, 1:1, 21:9 ; Flash Keyframe exclut auto). Tous peuvent générer à partir du texte seul. Les entrées de référence sont facultatives.
Les modèles Reference acceptent referenceImageUrls (jusqu'à 10), referenceVideoUrls (jusqu'à 5), elements (jusqu'à 7, au plus 3 avec vidéo) et keepOriginalSound. Un élément nommé possède name, soit imageUrls (2 à 4 images), soit videoUrl (un clip de personnage de 3 à 8 s), tag facultatif, description (100 caractères) et voiceUrl de personnage. Flash accepte aussi type d'élément (image ou video). Standard Reference accepte en plus voices : jusqu'à 3 objets avec name et audioUrl. Flash associe plutôt les voix aux éléments de personnage.
Il peut y avoir au maximum 15 images, vidéos de référence, éléments et voix autonomes combinés ; les vidéos de référence plus les éléments vidéo ne peuvent pas dépasser 5. Chaque vidéo de référence doit durer 2 à 30 s (2 à 20 s pour Flash), et leur durée cumulée, éléments vidéo inclus, est d'au maximum 30 s (20 s pour Flash). Les noms doivent être uniques sans tenir compte de la casse, composés de 1 à 20 caractères chinois, lettres, chiffres ou underscores ; les noms de référence intégrés sont réservés. Mentionnez les références fournies comme , ou leur déclaré. Les mentions non déclarées sont rejetées.
Chat GPT-6 Astra
Découvrez chat.gpt_6_astra avec GET /models/chat.gpt_6_astra (slug : gpt-6-astra). Il a le type chat et renvoie du texte. Discovery inclut les tarifs par token et la règle d’arrondi.
{
"model": "chat.gpt_6_astra",
"input": {
"prompt": "Explain what is in this image.",
"imageUrls": [
"https://example.com/image.png"
]
},
"parameters": {
"reasoningEffort": "high",
"webSearch": true,
"stream": false
}
}Send this body to POST /lab. Images are optional; up to 12 URLs or owned file IDs are accepted. Text-only requests use string input upstream; image requests use an array of message content. Reasoning effort: low, medium, high, xhigh (default low). Web search and streaming default to false. Streamed responses are returned as a completed task after generation finishes.
Pour proposer une fonction, transmettez input.functionTools sous forme de chaîne JSON contenant 1 à 10 définitions avec type: "function", name, description et parameters (un objet JSON Schema). Définissez parameters.webSearch sur false. La requête amont utilise tool_choice: "auto" ; les demandes de fonction sont renvoyées dans results[].function_calls pour être traitées par votre application. Le nœud de modèle n’exécute pas les fonctions et ne poursuit pas la conversation avec un résultat de fonction.
Le chat réserve 1 crédit avant d’entrer dans la file d’attente. Il s’agit d’une réservation minimale, et non d’un prix fixe ni d’un plafond de dépense. Tarifs par 1M tokens : entrée 560, entrée mise en cache 56, écritures de cache 700, sortie 2 800 crédits. Le coût total des tokens est arrondi à l’unité supérieure une seule fois à un crédit entier, avec un minimum facturé de 1. Après la réponse, tout frais supplémentaire est déduit de façon atomique du solde disponible. Si le solde est insuffisant, la tâche échoue et la réservation inutilisée est libérée.
Pour le chat et les images tarifés à l’usage, le point de terminaison d’estimation renvoie aussi credits_range avec min, max, assumptions, includes_markup: true, is_estimate: true et is_spending_cap: false. Affichez cela comme une plage approximative en crédits V4V. Cela inclut la majoration actuelle et les ajustements de prix. Il s’agit de scénarios d’utilisation illustratifs ; le coût réel peut se situer hors de cette plage. et décrivent séparément la réservation initiale. La plage ne modifie pas l’ajustement selon l’usage réel et n’active pas l’admission avec budget strict.
Laboratoire avec une image externe
Les entrées média acceptent une URL externe ou un ID de fichier V4V dans le même champ. Les tableaux peuvent mélanger les deux. Les URL doivent renvoyer de vrais fichiers média sans cookies de navigateur ni connexion interactive. HTTPS et des URL signées valides suffisamment longtemps sont recommandées. V4V valide et copie les médias externes avant la génération ; les URL de réseau interne et les redirections non sûres sont rejetées.
curl https://v4v.ai/api/v1/lab \
-H "Authorization: Bearer $V4V_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: product-edit-001' \
-d '{"model":"ai.image_edit","input":{"prompt":"Place this product on a marble counter","referenceImageUrls":["https://example.com/product.jpg"]},"parameters":{"variant":"nano-banana-2","aspectRatio":"9:16","resolution":"2K"}}'Téléverser des médias privés
POST /files accepte un champ file utilisant multipart/form-data. Les images, les vidéos et les fichiers audio sont pris en charge, sous réserve des limites du modèle. La limite de téléversement par défaut est de 100 Mio, encore contrainte par la limite de téléversement de stockage du déploiement et la limite du proxy. Les fichiers doivent contenir des médias décodables ; l’inspection audio/vidéo requiert ffprobe sur le serveur.
curl https://v4v.ai/api/v1/files \
-H "Authorization: Bearer $V4V_API_KEY" \
-F 'file=@product.png'{
"id": "6aa962444bd1dd7ab65bc6b6",
"type": "image",
"content_type": "image/png",
"size": 123456
}Utilisez directement l’ID renvoyé, sans préfixe file_. GET /files/{id} consulte les métadonnées de votre fichier sans consommer de crédits.
{
"model": "ai.image_edit",
"input": {
"prompt": "Create a studio product photograph",
"referenceImageUrls": [
"6aa962444bd1dd7ab65bc6b6",
"https://example.com/side.jpg"
]
},
"parameters": {
"variant": "nano-banana-2"
}
}Studio avec des médias externes ou privés
POST /studio utilise le même flux de travail Studio sélectionné, la même préparation, la même exécution du modèle, le même multiplicateur de prix et la même remise d’abonnement que l’interface Studio.
{
"input": {
"product_name": "Example Product",
"product_description": "Lightweight everyday backpack",
"product_images": [
"https://example.com/front.jpg",
"6aa962444bd1dd7ab65bc6b6"
],
"prompt": "Show the product in everyday use"
},
"parameters": {
"duration": 10,
"aspect_ratio": "9:16",
"style": "UGC",
"language": "en",
"avatar": null
},
"callback_url": "https://partner.example/webhooks/v4v"
}Pour un flux entièrement en médias privés, téléversez d’abord chaque image produit avec POST /files, puis placez les ID renvoyés dans input.product_images. Téléversez les références d’avatar, audio et vidéo de la même manière.
Studio accepte product_id (un produit enregistré détenu), avatar_id (un avatar de bibliothèque publique détenu ou public actif, avec préfixe public: pris en charge), product_name, product_description, prompt, product_images, reference_images, avatar_media, audio et video. Chaque champ média accepte des références ; les tableaux prennent en charge plusieurs fichiers. parameters.avatar accepte un ID d’avatar de bibliothèque, une URL d’image unique ou un ID de fichier, ou null. Choisissez soit input.avatar_id soit parameters.avatar. Les champs produit explicites remplacent les valeurs par défaut de la bibliothèque. Les noms/ID de style actifs appliquent les instructions de style enregistrées. Les valeurs de style inconnues, inactives et vides renvoient 422 INVALID_PARAMETER, field: "parameters.style" et error.allowed_values contenant les ID/noms actifs. Omettez le style pour utiliser la valeur par défaut actuelle (UGC si actif, sinon le premier préréglage actif). Les paramètres incluent aussi style, language, voice, placement, duration, aspect_ratio et quality.
Migration pour les clients qui transmettaient auparavant du texte libre dans : déplacez cette direction créative dans et choisissez un style actif depuis MCP (ou omettez le style pour la valeur par défaut actuelle). Un style mal orthographié ne devient plus un style personnalisé.
Tâches et crédits
La génération renvoie HTTP 202 après validation des entrées et, lorsque la capacité est disponible, réservation des crédits, sans attendre la génération :
{
"task_id": "task_6aa962444bd1dd7ab65bc6b6",
"status": "queued",
"credits_reserved": 20,
"created_at": "2026-09-15T18:00:00Z"
}Nom de projet facultatif
POST /lab et POST /studio acceptent tous deux project_name au niveau supérieur, aux côtés de input, parameters et callback_url :
{
"project_name": "Summer campaign — product photo",
"model": "image-upscale-topaz",
"input": {
"image_url": "https://example.com/product.png"
},
"parameters": {
"upscale_factor": "2"
}
}Le nom après suppression des espaces superflus (1 à 200 caractères, non vide) devient le titre dans Projets et, pour LAB, Anciennes exécutions. S’il est omis, le titre par défaut existant est utilisé. La réponse de la tâche inclut project_name et project_id. Changer le nom avec la même clé d’idempotence est un conflit, tout comme changer les entrées de génération.
Statut de la tâche
Le serveur actualise le statut de génération en arrière-plan. L’interrogation renvoie le dernier status enregistré : queued, processing, completed, failed ou cancelled. Tant que la tâche est queued ou processing, affichez un indicateur de chargement. Lorsque status vaut completed, lisez le texte du chat depuis results[].text ou téléchargez les fichiers média depuis results. Pour failed, examinez error (y compris le stage, brief_completed, retryable en échec et le retry_after_seconds suggéré lorsqu’ils sont connus) et credits_used. Une génération de brief réussie peut conserver sa facturation si le rendu échoue ; une indication de nouvelle tentative transitoire ne lance ni n’autorise une nouvelle tentative payante. cancelled est également terminal.
Les webhooks sont facultatifs. Sans callback_url, répétez la requête suivante toutes les 3 à 5 secondes jusqu’à ce que status soit completed, ou :
Renommer et organiser les projets
L’organisation des projets utilise les mêmes dossiers que l’espace de travail Projects. Elle ne génère pas de médias, ne réserve pas de crédits et ne modifie pas les entrées de génération, les résultats ni les hachages d’idempotence. Toutes les opérations nécessitent votre clé API et n’accèdent qu’aux projets et dossiers de votre compte.
| Méthode et chemin | Objet |
|---|---|
GET /projects | Rechercher les projets Studio, flux de travail et Lab, y compris les tâches API en file d’attente |
PATCH /projects/{project_id} | Renommer un projet et/ou le déplacer vers un dossier |
GET /project-folders | Lister les dossiers de l’espace de travail |
POST /project-folders | Créer un dossier avec {"name":"Summer campaign"} |
PATCH /project-folders/{folder_id} | Renommer un dossier avec {"name":"Autumn campaign"} |
Les deux points de terminaison de liste acceptent offset (0 par défaut) et limit (1–100, 50 par défaut), et renvoient total et next_offset (null sur la dernière page). Les projets sont triés du plus récent au plus ancien avec un départage stable par ID ; les dossiers sont triés par nom. Les filtres de projet sont source=all|studio|workflow|lab, q (recherche littérale du titre, insensible à la casse, jusqu’à 200 caractères) et folder_id (un ID de dossier appartenant au compte, ou unfiled pour aucun dossier). Omettez folder_id pour inclure tous les dossiers.
GET /projects renvoie projects avec project_id, project_name, source, folder_id (chaîne ou null), status, created_at et updated_at. Le statut reflète le projet d’origine ou l’historique Lab ; utilisez GET /tasks/{task_id} pour le statut de génération. Utilisez le renvoyé pour les mises à jour ; les entrées Lab héritées sans projet associé utilisent leur ID d’exécution Lab. renvoie avec , , , et .
Idempotence
Envoyez Idempotency-Key (1 à 200 caractères) lors de l’envoi de requêtes Lab ou Studio. Le même compte, la même valeur de clé, le même point de terminaison et le même contenu JSON renvoient la tâche d’origine, y compris via différentes clés API de ce compte. L’ordre des propriétés de l’objet est ignoré. La réutilisation d’une clé pour un contenu différent renvoie HTTP 409 IDEMPOTENCY_CONFLICT. Si la requête d’origine est encore en cours de validation, HTTP 409 REQUEST_IN_PROGRESS vous demande de réessayer avec la même clé. Un envoi rejeté reste associé à sa clé ; corrigez-le avec une nouvelle clé.
Des index uniques persistants empêchent que des nouvelles tentatives concurrentes créent une autre génération ou réservation. Les enregistrements d’idempotence restent associés à l’historique des tâches.
Callbacks signés
Fournissez un callback_url public facultatif. V4V envoie task.completed ou task.failed avec les champs de la tâche, la liste des résultats et le event_id stable. Les callbacks comportent les en-têtes X-V4V-Timestamp et X-V4V-Signature: v1=<hex>. Vérifiez-les à l’aide du secret de signature webhook affiché lors de la création de la clé API.
La signature est un HMAC-SHA256 calculé sur l’horodatage, un point littéral et le corps brut exact de la requête. Rejetez les horodatages trop anciens (par exemple, de plus de cinq minutes) et comparez les signatures en temps constant.
import crypto from 'node:crypto';
const expected = crypto.createHmac('sha256', webhookSecret)
.update(`${timestamp}.${rawBody}`).digest('hex');
const valid = /^v1=[a-f0-9]{64}$/.test(signature)
&& Math.abs(Date.now() / 1000 - Number(timestamp)) < 300
&& crypto.timingSafeEqual(Buffer.from(signature.slice(3), 'hex'), Buffer.from(expected, 'hex'));Renvoyez rapidement une réponse 2xx. La livraison a lieu au moins une fois : dédupliquez par event_id. Les échecs réseau, délais d’expiration, réponses HTTP 408/429 et réponses 5xx sont réessayés avec un backoff exponentiel, à partir de 30 secondes et plafonné à une heure, jusqu’à 12 tentatives par défaut. Les autres réponses non réussies, y compris les redirections, arrêtent la livraison. Les nouvelles tentatives ne créent jamais de générations et ne facturent jamais de crédits. Interrogez le statut de la tâche si la livraison du callback est épuisée.
Callbacks de lot Studio
POST /studio/batches accepte aussi un callback_url facultatif. La même vérification de callback signé s’applique. Les événements sont batch.updated, batch.completed, batch.paused et batch.cancelled, avec un event_id stable, batch_id, batch_revision, observed_at, state_token, des totaux et des crédits. Lisez GET /studio/batches/{batch_id} pour obtenir les résultats paginés actuels. Les événements contiennent des instantanés compacts plutôt que des URL de téléchargement expirantes ; les changements intermédiaires peuvent être regroupés entre les cycles du worker.
La livraison est durable et réessayée indépendamment de la génération. Dédupliquez par event_id et tolérez les événements hors ordre ; une livraison répétée conserve le même corps. Des récepteurs lents ou défaillants ne créent pas de nouvelles générations et ne bloquent pas la file de génération. L’annulation peut émettre une mise à jour supplémentaire lorsque le travail déjà admis se termine. Une demande ultérieure de redémarrage ou de reprise du travail réactive la supervision. Un webhook est une intégration HTTP et ne réveille pas à lui seul un chat de navigateur terminé.
Erreurs et limites
Les erreurs utilisent un format unique :
{
"error": {
"code": "INVALID_PARAMETER",
"message": "Allowed values: 5, 10.",
"field": "parameters.duration"
}
}HTTP 400/422 indique une entrée ou des paramètres invalides ; 401 une clé invalide/révoquée ; 402 des crédits insuffisants ; 403 des modèles désactivés ou un accès refusé ; 404 des modèles/fichiers/tâches indisponibles ; 409 un conflit d’idempotence ou une validation en cours ; 429 une limite de débit/concurrence ; 500 une erreur interne ; et 503 une indisponibilité temporaire du service. Les codes d’erreur incluent INVALID_API_KEY, INSUFFICIENT_CREDITS, MODEL_NOT_FOUND, MODEL_DISABLED, INVALID_INPUT, INVALID_PARAMETER, INVALID_MEDIA_URL, MEDIA_NOT_ACCESSIBLE, UNSUPPORTED_MEDIA_TYPE, MEDIA_TOO_LARGE, FILE_NOT_FOUND, FILE_ACCESS_DENIED, RATE_LIMIT_EXCEEDED, GENERATION_FAILED, GENERATION_SERVICE_ERROR et SERVICE_UNAVAILABLE. GENERATION_SERVICE_ERROR identifie une erreur interne du service de modèle signalée ; cela n’établit pas que la taille de l’entrée ou les paramètres étaient invalides. Les ID de fichier manquants et inaccessibles partagent une réponse 404 afin d’éviter de révéler les fichiers d’autres comptes.
Default limits are 120 requests per minute per key, 10 generation submissions per minute per account, and 3 concurrent accepted generations per account. Every HTTP 429 includes error.retryable and a positive integer error.retry_after_seconds; the HTTP Retry-After header uses the same value. Request-window errors also return reason: "request_rate_limit", the configured limit, and a public scope (key, generation, bulk, mcp-upload-link or mcp-upload), without internal account/key IDs. The retry delay is the rounded-up time remaining in the minute window, not always 60 seconds. MCP tool errors preserve these fields in their JSON even when HTTP headers are unavailable. Account contention uses its own reason: "account_busy" and one-second delay. Generation capacity is handled separately by the durable queue; wait for the accepted task rather than resubmitting it.
{
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "API rate limit exceeded. Retry after 18 seconds.",
"reason": "request_rate_limit",
"scope": "key",
"limit": 120,
"retryable": true,
"retry_after_seconds": 18
}
}Pour les rejets dans la fenêtre de requête (avant la création de la tâche), attendez le délai indiqué et réutilisez la même clé d’idempotence et les mêmes arguments. Une réponse identifiant une tâche déjà en échec est définitive pour cette tâche. Cela n’autorise pas une autre tentative payante après un échec terminal de génération.
Génération en masse Studio (API et MCP)
La génération en masse est disponible via l’API et MCP. Il n’existe pas encore d’espace de travail de génération en masse dans l’interface Studio. Envoyez jusqu’à 300 produits dans une seule requête JSON. Chaque élément crée un flux de travail Studio avec sa propre tâche, ses paramètres/flux de travail enregistrés, ses résultats et sa comptabilisation des crédits. L’import des produits et le téléchargement des références s’effectuent en arrière-plan ; un élément invalide échoue indépendamment tandis que les autres continuent.
Studio, LAB, REST, MCP, Shopify et la génération d’avatar partagent une file serveur persistante avec un plafond absolu de 10 requêtes de génération actives pour ce déploiement. L’attente d’un résultat de génération occupe un emplacement. Une génération terminée libère cet emplacement même pendant l’enregistrement de son fichier. Les requêtes ordinaires sont prioritaires sur les requêtes en masse ; le mode en masse utilise la capacité disponible, sous réserve des limites globales de masse et par compte définies par un administrateur. Les valeurs par défaut sont de 2 flux de travail en masse simultanés et 1 par compte. Plusieurs lots appartenant à un même compte partagent cette limite. Le traitement se poursuit sans navigateur ouvert ni interrogation du client.
Créer un lot
POST /api/v1/studio/batches — renvoie HTTP 202. Fournissez un en-tête Idempotency-Key obligatoire de 1 à 200 caractères. Réutilisez la même clé et un JSON identique après une interruption réseau. Un corps modifié avec la même clé renvoie HTTP 409 ; l’acceptation ne crée jamais un second lot lors d’une nouvelle tentative.
curl "$V4V_BASE_URL/api/v1/studio/batches" \
-H "Authorization: Bearer $V4V_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: autumn-catalogue-001' \
--data '{
"name": "Autumn catalogue",
"max_credits": 600,
"input": { "prompt": "Show three benefits of this product in a calm reveal" },
"parameters": { "duration": 8, "aspect_ratio": "9:16", "quality": "720p" },
"items": [
{ "sku": "MUG-01", "product_id": "0123456789abcdef01234567" },
{ "sku": "BAG-02", "product_url": "https://shop.example/products/bag?variant=blue" },
{
"sku": "LAMP-03",
"input": {
"product_name": "Desk lamp",
"product_description": "Adjustable warm light",
"product_images": ["https://shop.example/lamp.jpg"]
},
"parameters": { "style": "TV Spot" }
}
]
}'Utilisez la durée, le format et la qualité pris en charge par le flux de travail Studio actuel de votre déploiement, comme pour . L’exemple prévoit 600 crédits pour trois clips Omni de 8 secondes en 720p : 3 × 180 = 540 crédits, laissant 60 crédits de marge. Trois clips de 10 secondes en 720p utilisent 675 crédits ; en 1080p, 990 ; et en 4K, 1 980, avant la tarification des vidéos de référence, les étapes supplémentaires ou les nouvelles tentatives. Obtenez toujours les estimations actuelles pour les entrées exactes avant de choisir un budget de lot.