Crea con l'API V4V.
Genera immagini, video e audio dalle tue applicazioni. Una chiave API. I tuoi crediti V4V esistenti.
https://v4v.ai/api/v1curl https://v4v.ai/api/v1/models \
-H "Authorization: Bearer $V4V_API_KEY"Autenticazione
Crea una chiave con nome in Profilo → Chiavi API. Salva il segreto API e il segreto di firma del webhook quando compaiono; vengono mostrati una sola volta. È possibile creare e revocare più chiavi in modo indipendente. I segreti delle chiavi sono memorizzati come hash SHA-256.
Invia Authorization: Bearer v4v_live_… in ogni richiesta API. Conserva questa chiave sul tuo server, fuori dalle applicazioni browser e dal controllo versione. La revoca blocca le richieste future; le generazioni già accettate continuano.
URL di base: https://v4v.ai/api/v1.
Scopri i modelli LAB
GET /models elenca gli ID correnti dei modelli LAB, stato abilitato, input, parametri, valori predefiniti, condizioni e limiti. GET /models/{model} descrive un modello. ID e schemi provengono dallo stesso catalogo e dagli stessi valori predefiniti usati da LAB. La configurazione di Studio è separata.
I nomi dei modelli negli esempi qui sotto sono ID di catalogo reali. Usa discovery per trovare i modelli attualmente abilitati sul tuo account. I nomi dei campi sono specifici del modello: mantieni i nomi restituiti da discovery, inclusi i nomi in camelCase come aspectRatio o referenceImageUrls. I valori select sono stringhe; sono accettati anche valori numerici per opzioni select dall'aspetto numerico. I campi possono essere forniti in input o parameters, ma mai in entrambi. I campi sconosciuti vengono rifiutati. I modelli con versioni selezionabili espongono parameters.variant; usa i valori e i predefiniti restituiti da discovery.
curl https://v4v.ai/api/v1/models \
-H "Authorization: Bearer $V4V_API_KEY"Sottotitoli vocali temporizzati
Trova ai.speech_to_text con tipo subtitle. Invia un ID di file multimediale posseduto o un URL supportato in input.audioUrl o input.videoUrl a POST /lab; i parametri facoltativi includono language_code (per esempio uk, en o auto) e diarize. La stima usa la durata originale della sorgente. La trascrizione consuma i normali crediti dell'account.
Un task completato restituisce results[].type: "subtitle", la trascrizione text, srt e cues modificabile con start, end in secondi e text. Un input silenzioso riuscito può avere un elenco di cue vuoto. Per il montaggio, usa gli strumenti MCP di Video Editor per allineare questi cue al trim, alla velocità e alla posizione nella timeline di una clip sorgente.
Modelli di generazione più recenti
Omni Flash 1.2 (video.gemini_omni_flash-1-2) è il modello preferito per le richieste video senza un modello esplicito. Il Laboratorio lo elenca per primo; Omni Flash 1.1 resta disponibile in Altro e tramite il suo ID esistente. Scopri i parametri attuali con GET /models/{model}. La versione 1.2 supporta generazione e modifica da 3 a 15 secondi; l'interpolazione first/last-frame è limitata a 10 secondi. Le tariffe condivise da 4/6/8/10 secondi corrispondono ai prezzi 1.1 configurati. Usa discovery ed estimates attuali per i prezzi invece di memorizzare questa relazione come regola permanente.
Scegli GPT Image 2.6 tramite parameters.variant in image.text_to_image o ai.image_edit. Usa parameters.outputFormat con queste capacità esatte delle varianti:
| Variante | Formati di output |
|---|---|
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 è autorevole. Flare/Sunburst vengono regolati in base all'uso effettivo di input/output; l'uso della conversione SVG è incluso nel totale finale. Economy è solo 1K con prezzo per immagine. I download mantengono i frame GIF e i byte vettoriali SVG; i download SVG usano la consegna come allegato.
Nano Banana 2.1 usa parameters.variant: "nano-banana-v2.1" negli stessi moduli immagine, con fino a 10 riferimenti e output 1K/2K/4K. La modalità di fatturazione attuale è pubblicata in . La generazione Google/Vertex viene regolata in base a input verificato, input in cache, output immagine, output testo e token di thinking, con markup applicato e totale combinato arrotondato una sola volta per eccesso. La componente di output immagine è circa 11/16/36 crediti V4V per 1K/2K/4K prima di input e thinking. Il Laboratorio e le estimates mostrano un intervallo approssimativo; la prenotazione iniziale è separata dal costo finale. Gli altri instradamenti usano la tariffa per immagine configurata. L'instradamento resta gestito da V4V; non fornire un parametro di routing.
Modelli video Kling 4.0
Quattro nodi separati condividono la stessa gestione di generazione e risultati in Laboratorio, Flussi di lavoro, API e MCP:
| ID catalogo | Modello | Durata | Risoluzione |
|---|---|---|---|
video.kling_v40_ref | Kling 4.0 Reference | 3–30 secondi | 720p / 1080p |
video.kling_v40_key | Kling 4.0 Keyframe | 3–30 secondi | 720p / 1080p |
video.kling_v40_flash_ref | Kling 4.0 Flash Reference | 3–20 secondi | 720p |
video.kling_v40_flash_key | Kling 4.0 Flash Keyframe | 3–20 secondi | 720p |
Tutti accettano un prompt obbligatorio (fino a 8000 caratteri), duration intero, resolution e aspectRatio (auto, 16:9, 9:16, 1:1, 21:9; Flash Keyframe esclude auto). Tutti possono generare dal solo testo. Gli input di riferimento sono facoltativi.
I modelli Reference accettano referenceImageUrls (fino a 10), referenceVideoUrls (fino a 5), elements (fino a 7, al massimo 3 con video) e keepOriginalSound. Un elemento denominato ha name, oppure imageUrls (2–4 immagini) oppure videoUrl (una clip personaggio di 3–8 s), tag facoltativo, description (100 caratteri) e voiceUrl del personaggio. Flash accetta anche l'elemento type (image o video). Standard Reference accetta inoltre voices: fino a 3 oggetti con name e audioUrl. Flash invece associa le voci agli elementi personaggio.
Ci sono al massimo 15 tra immagini, riferimenti video, elementi e voci standalone combinati; i video di riferimento più gli elementi video non possono superare 5. Ogni video di riferimento deve durare 2–30 s (2–20 s per Flash), e la loro durata combinata inclusi gli elementi video è al massimo di 30 s (20 s per Flash). I nomi devono essere univoci ignorando maiuscole e minuscole, 1–20 caratteri cinesi, lettere, cifre o underscore; i nomi di riferimento incorporati sono riservati. Cita i riferimenti forniti come , o con il loro dichiarato. Le menzioni non dichiarate vengono rifiutate.
Chat GPT-6 Astra
Trova chat.gpt_6_astra con GET /models/chat.gpt_6_astra (slug: gpt-6-astra). Ha tipo chat e restituisce testo. Discovery include le tariffe dei token e la regola di arrotondamento.
{
"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.
Per offrire una funzione, passa input.functionTools come stringa JSON contenente 1–10 definizioni con type: "function", name, description e parameters (un oggetto JSON Schema). Imposta parameters.webSearch su false. La richiesta upstream usa tool_choice: "auto"; le richieste di funzione vengono restituite in results[].function_calls perché la tua applicazione le gestisca. Il nodo del modello non esegue funzioni né continua la conversazione con il risultato di una funzione.
La chat riserva 1 credito prima di entrare in coda. Questa è una prenotazione minima, non un prezzo fisso né un tetto di spesa. Tariffe per 1M token: input 560, input in cache 56, scritture in cache 700, output 2.800 crediti. Il costo combinato dei token viene arrotondato per eccesso una sola volta a un credito intero, con un addebito minimo di 1. Dopo la risposta, ogni addebito aggiuntivo viene detratto atomicamente dal saldo disponibile. Se il saldo è insufficiente, il task fallisce e la prenotazione non usata viene rilasciata.
Per chat e immagini con prezzo basato sull'uso, l'endpoint estimate restituisce anche credits_range con min, max, assumptions, includes_markup: true, is_estimate: true e is_spending_cap: false. Mostralo come intervallo approssimativo in crediti V4V. Include il markup attuale e gli adeguamenti di prezzo. Questi sono scenari d'uso illustrativi; il costo reale può essere fuori intervallo. e descrivono separatamente la prenotazione iniziale. L'intervallo non modifica la regolazione in base all'uso effettivo né abilita l'ammissione con budget rigido.
LAB con un'immagine esterna
Gli input multimediali accettano un URL esterno o un ID file V4V nello stesso campo. Gli array possono mescolare entrambi. Gli URL devono restituire file multimediali reali senza cookie del browser né login interattivo. Sono consigliati HTTPS e URL firmati con durata sufficientemente lunga. V4V valida e copia i media esterni prima della generazione; gli URL di rete interna e i reindirizzamenti non sicuri vengono rifiutati.
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"}}'Carica media privati
POST /files accetta un campo file usando multipart/form-data. Sono supportati immagini, video e audio, nel rispetto dei limiti del modello. Il limite di upload predefinito è 100 MiB, ulteriormente vincolato dal limite di upload dello storage del deployment e dal limite del proxy. I file devono contenere media decodificabili; l'ispezione audio/video richiede ffprobe sul server.
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
}Usa direttamente l'ID restituito, senza prefisso file_. GET /files/{id} recupera i metadati del tuo file senza consumare crediti.
{
"model": "ai.image_edit",
"input": {
"prompt": "Create a studio product photograph",
"referenceImageUrls": [
"6aa962444bd1dd7ab65bc6b6",
"https://example.com/side.jpg"
]
},
"parameters": {
"variant": "nano-banana-2"
}
}Studio con media esterni o privati
POST /studio usa lo stesso flusso di lavoro Studio selezionato, la stessa preparazione, esecuzione del modello, moltiplicatore di prezzo e sconto dell'abbonamento dell'interfaccia 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"
}Per un flusso completamente con media privati, carica prima ogni immagine prodotto usando POST /files, poi inserisci gli ID restituiti in input.product_images. Carica allo stesso modo avatar, audio e riferimenti video.
Studio accetta product_id (un prodotto salvato posseduto), avatar_id (un avatar della libreria pubblica posseduto o attivo, con prefisso public: supportato), product_name, product_description, prompt, product_images, reference_images, avatar_media, audio e video. Ogni campo multimediale accetta riferimenti; gli array supportano più file. parameters.avatar accetta un ID avatar della libreria, un singolo URL immagine o ID file, oppure null. Scegli tra input.avatar_id o parameters.avatar. I campi prodotto espliciti sostituiscono i valori predefiniti della libreria. I nomi/ID di stile attivi applicano le istruzioni di stile salvate. Valori di stile sconosciuti, inattivi o vuoti restituiscono 422 INVALID_PARAMETER, field: "parameters.style" e error.allowed_values contenenti gli ID/nomi attivi. Ometti lo stile per usare il predefinito attuale (UGC se attivo, altrimenti il primo preset attivo). I parametri includono anche style, language, voice, placement, duration, aspect_ratio e quality.
Migrazione per i client che in precedenza passavano testo libero in parameters.style: sposta quella direzione creativa in input.prompt e scegli uno stile attivo da MCP (oppure ometti lo stile per il predefinito attuale). Uno stile scritto in modo errato non diventa più uno stile personalizzato.
Task e crediti
La generazione restituisce HTTP 202 dopo la validazione dell'input e, quando la capacità è disponibile, la prenotazione dei crediti, senza attendere la generazione:
{
"task_id": "task_6aa962444bd1dd7ab65bc6b6",
"status": "queued",
"credits_reserved": 20,
"created_at": "2026-09-15T18:00:00Z"
}Nome progetto facoltativo
Sia POST /lab sia POST /studio accettano project_name al livello superiore, insieme a input, parameters e callback_url:
{
"project_name": "Summer campaign — product photo",
"model": "image-upscale-topaz",
"input": {
"image_url": "https://example.com/product.png"
},
"parameters": {
"upscale_factor": "2"
}
}Il nome ripulito (1–200 caratteri, non vuoto) diventa il titolo in Progetti e, per LAB, in Vecchie esecuzioni. Se omesso, viene usato il titolo predefinito esistente. La risposta del task include project_name e project_id. Cambiare il nome con la stessa chiave di idempotenza crea un conflitto, proprio come cambiare gli input di generazione.
Stato del task
Il server aggiorna lo stato della generazione in background. Il polling restituisce l'ultimo status salvato: queued, processing, completed, failed o cancelled. Mentre il task è queued o processing, mostra un indicatore di caricamento. Quando status è completed, leggi il testo della chat da results[].text o scarica i file multimediali da results. Per failed, controlla error (inclusi i valori non riusciti stage, brief_completed, retryable e il suggerimento retry_after_seconds dove noto) e credits_used. Una generazione breve riuscita può mantenere il suo addebito se il rendering fallisce; un suggerimento di nuovo tentativo transitorio non avvia né autorizza un nuovo tentativo a pagamento. Anche cancelled è terminale.
I webhook sono facoltativi. Senza callback_url, ripeti la seguente richiesta ogni 3–5 secondi finché status non è completed, failed o cancelled:
Rinominare e organizzare i progetti
L'organizzazione dei progetti usa le stesse cartelle dell'area di lavoro Projects. Non genera contenuti multimediali, non riserva crediti e non modifica input di generazione, risultati o hash di idempotenza. Tutte le operazioni richiedono la tua chiave API e accedono solo ai progetti e alle cartelle del tuo account.
| Metodo e percorso | Scopo |
|---|---|
GET /projects | Trova progetti Studio, flussi di lavoro e LAB, incluse le attività API in coda |
PATCH /projects/{project_id} | Rinomina un progetto e/o spostalo in una cartella |
GET /project-folders | Elenca le cartelle dell'area di lavoro |
POST /project-folders | Crea una cartella con {"name":"Summer campaign"} |
PATCH /project-folders/{folder_id} | Rinomina una cartella con {"name":"Autumn campaign"} |
Entrambi gli endpoint di elenco accettano offset (predefinito 0) e limit (1–100, predefinito 50), restituendo total e next_offset (null nell'ultima pagina). I progetti sono ordinati dal più recente al meno recente con un criterio stabile di spareggio basato su ID; le cartelle sono ordinate per nome. I filtri dei progetti sono source=all|studio|workflow|lab, q (ricerca letterale del titolo, senza distinzione tra maiuscole e minuscole, fino a 200 caratteri) e folder_id (un ID cartella posseduto, oppure unfiled per nessuna cartella). Ometti folder_id per includere tutte le cartelle.
GET /projects restituisce projects con project_id, project_name, source, folder_id (stringa o null), status, created_at e updated_at. Lo stato riflette il progetto originale o la cronologia LAB; usa GET /tasks/{task_id} per lo stato della generazione. Usa il valore restituito per gli aggiornamenti; le voci LAB legacy senza un progetto sottostante usano il loro ID esecuzione LAB. restituisce con , , , e .
Idempotenza
Invia Idempotency-Key (1–200 caratteri) quando invii richieste LAB o Studio. Lo stesso account, valore della chiave, endpoint e contenuto JSON restituiscono l'attività originale, anche tra chiavi API diverse dello stesso account. L'ordine delle proprietà dell'oggetto viene ignorato. Riutilizzare una chiave per contenuti diversi restituisce HTTP 409 IDEMPOTENCY_CONFLICT. Se la richiesta originale è ancora in fase di convalida, HTTP 409 REQUEST_IN_PROGRESS ti chiede di riprovare con la stessa chiave. Un invio rifiutato resta associato alla sua chiave; correggilo usando una nuova chiave.
Indici univoci persistenti impediscono che tentativi simultanei creino un'altra generazione o prenotazione. I record di idempotenza restano insieme alla cronologia delle attività.
Callback firmati
Fornisci un callback_url pubblico facoltativo. V4V invia task.completed o task.failed con i campi dell'attività, l'elenco dei risultati e il valore stabile event_id. I callback hanno intestazioni X-V4V-Timestamp e X-V4V-Signature: v1=<hex>. Verifica usando il segreto di firma del webhook mostrato quando è stata creata la chiave API.
La firma è HMAC-SHA256 sul timestamp, un punto letterale e il corpo grezzo esatto della richiesta. Rifiuta timestamp non più validi (per esempio, più vecchi di cinque minuti) e confronta le firme in tempo costante.
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'));Restituisci rapidamente una risposta 2xx. La consegna avviene almeno una volta: deduplica in base a event_id. Errori di rete, timeout, risposte HTTP 408/429 e 5xx vengono ritentati con backoff esponenziale, a partire da 30 secondi e con limite massimo di un'ora, per un massimo predefinito di 12 tentativi. Altre risposte non riuscite, inclusi i reindirizzamenti, interrompono la consegna. I tentativi non creano mai generazioni né addebitano crediti. Esegui il polling dello stato dell'attività se la consegna del callback esaurisce i tentativi.
Callback batch Studio
POST /studio/batches accetta anche un callback_url facoltativo. Si applica la stessa verifica dei callback firmati. Gli eventi sono batch.updated, batch.completed, batch.paused e batch.cancelled, con un valore stabile event_id, batch_id, batch_revision, observed_at, state_token, conteggi e totali dei crediti. Leggi GET /studio/batches/{batch_id} per i risultati correnti paginati. Gli eventi contengono snapshot compatti invece di URL di download in scadenza; le modifiche intermedie possono essere accorpate tra i tick del worker.
La consegna è durevole e viene ritentata indipendentemente dalla generazione. Deduplica in base a event_id e tollera eventi fuori ordine; le consegne ripetute mantengono lo stesso corpo. Ricevitori lenti o con errori non creano nuove generazioni né bloccano la coda di generazione. L'annullamento può emettere un ulteriore aggiornamento quando il lavoro già ammesso termina. Un successivo riavvio o rifacimento richiesto riattiva il monitoraggio. Un webhook è un'integrazione HTTP e non riattiva di per sé una chat del browser già terminata.
Errori e limiti
Gli errori usano un unico formato:
{
"error": {
"code": "INVALID_PARAMETER",
"message": "Allowed values: 5, 10.",
"field": "parameters.duration"
}
}HTTP 400/422 indica input o parametri non validi; 401 una chiave non valida/revocata; 402 crediti insufficienti; 403 modelli disabilitati o accesso negato; 404 modelli/file/attività non disponibili; 409 un conflitto di idempotenza o una convalida in corso; 429 un limite di frequenza/concorrenza; 500 un errore interno; e 503 indisponibilità temporanea del servizio. I codici di errore includono 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 e SERVICE_UNAVAILABLE. GENERATION_SERVICE_ERROR identifica un errore interno segnalato del servizio del modello; non dimostra che la dimensione dell'input o i parametri fossero non validi. Gli ID file mancanti e quelli non accessibili condividono una risposta 404 per evitare di rivelare i file di altri account.
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
}
}Per i rifiuti nella finestra della richiesta (prima della creazione dell'attività), attendi il ritardo indicato e riutilizza la stessa chiave di idempotenza e gli stessi argomenti. Una risposta che identifica un'attività già non riuscita è definitiva per quell'attività. Questo non autorizza un altro tentativo a pagamento dopo un errore terminale di generazione.
Generazione in blocco Studio (API e MCP)
La generazione in blocco è disponibile tramite API e MCP. Non esiste ancora un'area di lavoro in blocco nell'interfaccia Studio. Invia fino a 300 prodotti in una richiesta JSON. Ogni elemento crea un flusso di lavoro Studio con la propria attività, il flusso di lavoro/le impostazioni salvati, i risultati e il conteggio dei crediti. L'importazione del prodotto e i download dei riferimenti avvengono in background; un elemento non valido fallisce in modo indipendente mentre gli elementi rimanenti continuano.
Studio, LAB, REST, MCP, Shopify e la generazione di avatar condividono una coda server persistente con un limite massimo assoluto di 10 richieste di generazione attive per questa distribuzione. L'attesa del risultato di una generazione occupa uno slot. Una generazione completata libera quello slot anche mentre il suo file viene salvato. Le richieste ordinarie hanno priorità su quelle in blocco; l'elaborazione in blocco usa la capacità disponibile, soggetta ai limiti globali in blocco e per account dell'amministratore. I valori predefiniti sono 2 flussi di lavoro in blocco simultanei e 1 per account. Più batch appartenenti allo stesso account condividono questo limite. L'elaborazione continua senza un browser aperto o polling del client.
Crea un batch
POST /api/v1/studio/batches — restituisce HTTP 202. Fornisci un'intestazione Idempotency-Key obbligatoria di 1–200 caratteri. Riutilizza la stessa chiave e lo stesso JSON dopo un'interruzione di rete. Un corpo modificato con la stessa chiave restituisce HTTP 409; l'accettazione non crea mai un secondo batch per un tentativo ripetuto.
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" }
}
]
}'Usa durata, formato e qualità supportati dal flusso di lavoro Studio attuale della tua distribuzione, come per POST /api/v1/studio. L'esempio prevede un budget di 600 crediti per tre clip Omni da 8 secondi a 720p: 3 × 180 = 540 crediti, lasciando 60 crediti di margine. Tre clip da 10 secondi a 720p usano 675 crediti; a 1080p ne usano 990 e a 4K 1.980, prima del prezzo del video di riferimento, dei passaggi extra o dei tentativi ripetuti. Ottieni sempre stime aggiornate per gli input esatti prima di scegliere un budget batch.