Crea con la API de V4V.
Genera imágenes, vídeo y audio desde tus propias aplicaciones. Una clave API. Tus créditos de V4V actuales.
https://v4v.ai/api/v1curl https://v4v.ai/api/v1/models \
-H "Authorization: Bearer $V4V_API_KEY"Autenticación
Crea una clave con nombre en Perfil → Claves de API. Guarda el secreto de API y el secreto de firma del webhook cuando aparezcan; solo se muestran una vez. Se pueden crear y revocar varias claves de forma independiente. Los secretos de clave se almacenan como hashes SHA-256.
Envía Authorization: Bearer v4v_live_… en cada solicitud de API. Mantén esta clave en tu servidor, fuera de las aplicaciones de navegador y del control de código fuente. La revocación bloquea futuras solicitudes; las generaciones ya aceptadas continúan.
URL base: https://v4v.ai/api/v1.
Descubrir modelos de Laboratorio
GET /models enumera los ID de modelos actuales de Laboratorio, estado habilitado, entradas, parámetros, valores predeterminados, condiciones y límites. GET /models/{model} describe un modelo. Los ID y esquemas proceden del mismo catálogo y de los mismos valores predeterminados que usa Laboratorio. La configuración de Estudio es independiente.
Los nombres de modelo en los ejemplos siguientes son IDs reales del catálogo. Usa discovery para encontrar los modelos habilitados actualmente en tu cuenta. Los nombres de campo son específicos del modelo: conserva los nombres devueltos por discovery, incluidos los nombres en camelCase como aspectRatio o referenceImageUrls. Los valores de selección son cadenas; también se aceptan valores numéricos para opciones de selección con apariencia numérica. Los campos pueden proporcionarse en input o en parameters, pero nunca en ambos. Los campos desconocidos se rechazan. Los modelos con versiones seleccionables exponen parameters.variant; usa los valores y valores predeterminados devueltos por discovery.
curl https://v4v.ai/api/v1/models \
-H "Authorization: Bearer $V4V_API_KEY"Subtítulos temporizados del habla
Descubre ai.speech_to_text con el tipo subtitle. Envía un ID de archivo multimedia propio o una URL compatible en input.audioUrl o input.videoUrl a POST /lab; los parámetros opcionales incluyen language_code (por ejemplo uk, en o auto) y diarize. La estimación usa la duración original de la fuente. La transcripción consume créditos normales de la cuenta.
Una tarea completada devuelve results[].type: "subtitle", la transcripción text, srt y cues editable con start, end en segundos y text. Una entrada silenciosa correcta puede tener una lista de cues vacía. Para montaje, usa las herramientas MCP del Editor de vídeo para alinear estos cues con el recorte, la velocidad y la posición en la línea de tiempo de un clip fuente.
Modelos de última generación
Omni Flash 1.2 (video.gemini_omni_flash-1-2) es el modelo preferido para solicitudes de vídeo sin un modelo explícito. El Laboratorio lo muestra primero; Omni Flash 1.1 sigue disponible en Más y con su ID actual. Descubre los parámetros actuales con GET /models/{model}. La versión 1.2 admite generación y edición de 3 a 15 segundos; la interpolación entre primer/último fotograma está limitada a 10 segundos. Las tarifas compartidas de 4/6/8/10 segundos coinciden con los precios configurados de la 1.1. Usa discovery y las estimaciones actuales para los precios en lugar de guardar esta relación como una regla permanente.
Elige GPT Image 2.6 mediante parameters.variant en image.text_to_image o ai.image_edit. Usa parameters.outputFormat con estas capacidades exactas por variante:
| Variante | Formatos de salida |
|---|---|
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 es la fuente autorizada. Flare/Sunburst se liquidan según el uso real de entrada/salida; el uso de conversión SVG se incluye en el total final. Economy es solo 1K con precio por imagen. Las descargas conservan los fotogramas GIF y los bytes vectoriales SVG; las descargas SVG usan entrega como archivo adjunto.
Nano Banana 2.1 usa parameters.variant: "nano-banana-v2.1" en los mismos módulos de imagen, con hasta 10 referencias y salida 1K/2K/4K. Su modo de facturación actual se publica en . La generación de Google/Vertex se liquida a partir de la entrada verificada, la entrada en caché, la salida de imagen, la salida de texto y los tokens de thinking, con margen aplicado y el total combinado redondeado hacia arriba una sola vez. El componente de salida de imagen es de aproximadamente 11/16/36 créditos V4V para 1K/2K/4K antes de la entrada y del thinking. El Laboratorio y las estimaciones muestran un rango aproximado; la reserva inicial es independiente del coste final. Otras rutas usan la tarifa por imagen configurada. La gestión del enrutamiento sigue estando a cargo de V4V; no proporciones un parámetro de routing.
Modelos de vídeo Kling 4.0
Cuatro nodos independientes comparten la misma gestión de generación y resultados en Laboratorio, Flujos de trabajo, API y MCP:
| ID de catálogo | Modelo | Duración | Resolución |
|---|---|---|---|
video.kling_v40_ref | Kling 4.0 Reference | 3–30 segundos | 720p / 1080p |
video.kling_v40_key | Kling 4.0 Keyframe | 3–30 segundos | 720p / 1080p |
video.kling_v40_flash_ref | Kling 4.0 Flash Reference | 3–20 segundos | 720p |
video.kling_v40_flash_key | Kling 4.0 Flash Keyframe | 3–20 segundos | 720p |
Todos aceptan un prompt obligatorio (hasta 8000 caracteres), un duration entero, resolution y aspectRatio (auto, 16:9, 9:16, 1:1, 21:9; Flash Keyframe excluye auto). Todos pueden generar solo a partir de texto. Las entradas de referencia son opcionales.
Los modelos Reference aceptan referenceImageUrls (hasta 10), referenceVideoUrls (hasta 5), elements (hasta 7, como máximo 3 con vídeo) y keepOriginalSound. Un elemento con nombre tiene name, ya sea imageUrls (2–4 imágenes) o videoUrl (un clip de personaje de 3–8 s), además de tag opcional, description (100 caracteres) y voiceUrl de personaje. Flash también acepta type del elemento (image o video). Standard Reference acepta además voices: hasta 3 objetos con name y audioUrl. En cambio, Flash vincula las voces a elementos de personaje.
Hay como máximo 15 imágenes, referencias de vídeo, elementos y voces independientes combinados; los vídeos de referencia más los elementos de vídeo no pueden superar 5. Cada vídeo de referencia debe durar 2–30 s (2–20 s para Flash), y su duración combinada, incluidos los elementos de vídeo, es como máximo de 30 s (20 s para Flash). Los nombres deben ser únicos sin distinguir mayúsculas de minúsculas, de 1–20 caracteres chinos, letras, dígitos o guiones bajos; los nombres de referencia integrados están reservados. Menciona las referencias proporcionadas como , o su declarado. Las menciones no declaradas se rechazan.
Chat GPT-6 Astra
Descubre chat.gpt_6_astra con GET /models/chat.gpt_6_astra (slug: gpt-6-astra). Tiene el tipo chat y devuelve texto. El discovery incluye las tarifas por token y la regla de redondeo.
{
"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.
Para ofrecer una función, pasa input.functionTools como una cadena JSON que contenga de 1 a 10 definiciones con type: "function", name, description y parameters (un objeto JSON Schema). Establece parameters.webSearch en false. La solicitud upstream usa tool_choice: "auto"; las solicitudes de función se devuelven en results[].function_calls para que tu aplicación las gestione. El nodo de modelo no ejecuta funciones ni continúa la conversación con el resultado de una función.
Chat reserva 1 crédito antes de entrar en la cola. Esta es una reserva mínima, no un precio fijo ni un límite de gasto. Tarifas por 1M tokens: entrada 560, entrada en caché 56, escrituras de caché 700, salida 2.800 créditos. El coste combinado de tokens se redondea hacia arriba una sola vez a un crédito entero, con un cargo mínimo de 1. Después de la respuesta, cualquier cargo adicional se deduce de forma atómica del saldo disponible. Si el saldo es insuficiente, la tarea falla y la reserva no utilizada se libera.
Para chat e imágenes con precio por uso, el endpoint de estimación también devuelve credits_range con min, max, assumptions, includes_markup: true, is_estimate: true y is_spending_cap: false. Muéstralo como un rango aproximado en créditos V4V. Incluye el margen actual y los ajustes de precio. Estos son escenarios de uso ilustrativos; el coste real puede quedar fuera del rango. y describen la reserva inicial por separado. El rango no altera la liquidación por uso real ni habilita la admisión con presupuesto rígido.
LAB con una imagen externa
Las entradas multimedia aceptan una URL externa o un ID de archivo de V4V en el mismo campo. Los arrays pueden mezclar ambos. Las URL deben devolver archivos multimedia reales sin cookies del navegador ni inicio de sesión interactivo. Se recomiendan HTTPS y URL firmadas con una validez suficientemente larga. V4V valida y copia los archivos multimedia externos antes de la generación; se rechazan las URL de redes internas y las redirecciones inseguras.
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"}}'Subir contenido multimedia privado
POST /files acepta un campo file usando multipart/form-data. Se admiten imágenes, vídeo y audio, sujetos a los límites del modelo. El límite de subida predeterminado es 100 MiB, restringido además por el límite de subida de almacenamiento y el límite del proxy de la implementación. Los archivos deben contener contenido multimedia decodificable; la inspección de audio/vídeo requiere ffprobe en el servidor.
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 directamente el ID devuelto, sin prefijo file_. GET /files/{id} consulta los metadatos de tu archivo sin consumir créditos.
{
"model": "ai.image_edit",
"input": {
"prompt": "Create a studio product photograph",
"referenceImageUrls": [
"6aa962444bd1dd7ab65bc6b6",
"https://example.com/side.jpg"
]
},
"parameters": {
"variant": "nano-banana-2"
}
}Estudio con contenido multimedia externo o privado
POST /studio usa el mismo flujo de trabajo de Estudio seleccionado, preparación, ejecución del modelo, multiplicador de precio y descuento de suscripción que la interfaz de Estudio.
{
"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"
}Para un flujo totalmente privado, primero sube cada imagen de producto usando POST /files y después pon los IDs devueltos en input.product_images. Sube las referencias de avatar, audio y vídeo del mismo modo.
Estudio acepta product_id (un producto guardado propio), avatar_id (un avatar de biblioteca propio o público activo, con prefijo public: compatible), product_name, product_description, prompt, product_images, reference_images, avatar_media, audio y video. Cada campo multimedia acepta referencias; los arrays admiten varios archivos. parameters.avatar acepta un ID de avatar de biblioteca, una única URL de imagen o ID de archivo, o null. Elige input.avatar_id o parameters.avatar. Los campos de producto explícitos sustituyen los valores predeterminados de la biblioteca. Los nombres/IDs de estilo activos aplican las instrucciones de estilo guardadas. Los valores de estilo desconocidos, inactivos o vacíos devuelven 422 INVALID_PARAMETER, field: "parameters.style" y error.allowed_values que contienen los IDs/nombres activos. Omite el estilo para usar el valor predeterminado actual (UGC cuando esté activo; en caso contrario, el primer preset activo). Los parámetros también incluyen style, language, voice, placement, duration, aspect_ratio y quality.
Migración para clientes que antes pasaban texto libre en parameters.style: mueve esa dirección creativa a y elige un estilo activo desde MCP (o omite el estilo para usar el valor predeterminado actual). Un estilo mal escrito ya no se convierte en un estilo personalizado.
Tareas y créditos
La generación devuelve HTTP 202 después de validar la entrada y, cuando hay capacidad disponible, de reservar créditos, sin esperar a la generación:
{
"task_id": "task_6aa962444bd1dd7ab65bc6b6",
"status": "queued",
"credits_reserved": 20,
"created_at": "2026-09-15T18:00:00Z"
}Nombre de proyecto opcional
Tanto POST /lab como POST /studio aceptan project_name en el nivel superior, junto con input, parameters y callback_url:
{
"project_name": "Summer campaign — product photo",
"model": "image-upscale-topaz",
"input": {
"image_url": "https://example.com/product.png"
},
"parameters": {
"upscale_factor": "2"
}
}El nombre recortado (de 1 a 200 caracteres, no vacío) pasa a ser el título en Proyectos y, para LAB, en ejecuciones antiguas. Si se omite, se usa el título predeterminado existente. La respuesta de la tarea incluye project_name y project_id. Cambiar el nombre con la misma clave de idempotencia es un conflicto, igual que cambiar las entradas de generación.
Estado de la tarea
El servidor actualiza el estado de la generación en segundo plano. El sondeo devuelve el último status guardado: queued, processing, completed, failed o cancelled. Mientras la tarea esté en queued o processing, muestra un indicador de carga. Cuando status sea completed, lee el texto del chat desde results[].text o descarga los archivos multimedia desde results. Para failed, inspecciona error (incluidos el stage, brief_completed, retryable fallidos y el retry_after_seconds sugerido cuando se conozca) y credits_used. Una generación breve correcta puede conservar su cargo si el renderizado falla; una sugerencia de reintento transitoria no inicia ni autoriza un nuevo intento de pago. cancelled también es terminal.
Los webhooks son opcionales. Sin callback_url, repite la siguiente solicitud cada 3–5 segundos hasta que status sea completed, failed o cancelled:
Renombrar y organizar proyectos
La organización de proyectos utiliza las mismas carpetas que el espacio de trabajo de Projects. No genera contenido multimedia, no reserva créditos ni cambia las entradas de generación, los resultados ni los hashes de idempotencia. Todas las operaciones requieren tu clave de API y solo acceden a los proyectos y carpetas de tu cuenta.
| Método y ruta | Finalidad |
|---|---|
GET /projects | Encontrar proyectos de Estudio, Flujos de trabajo y Laboratorio, incluidas las tareas de API en cola |
PATCH /projects/{project_id} | Renombrar un proyecto y/o moverlo a una carpeta |
GET /project-folders | Listar las carpetas del espacio de trabajo |
POST /project-folders | Crear una carpeta con {"name":"Summer campaign"} |
PATCH /project-folders/{folder_id} | Renombrar una carpeta con {"name":"Autumn campaign"} |
Ambos endpoints de listado aceptan offset (valor predeterminado: 0) y limit (1–100, valor predeterminado: 50), y devuelven total y next_offset (null en la última página). Los proyectos se ordenan del más reciente al más antiguo con un desempate estable por ID; las carpetas se ordenan por nombre. Los filtros de proyecto son source=all|studio|workflow|lab, q (búsqueda literal del título, sin distinguir mayúsculas de minúsculas, de hasta 200 caracteres) y folder_id (un ID de carpeta en propiedad, o unfiled para ninguna carpeta). Omite folder_id para incluir todas las carpetas.
GET /projects devuelve projects con project_id, project_name, source, folder_id (cadena o null), status, created_at y updated_at. El estado refleja el proyecto original o el historial del Laboratorio; usa GET /tasks/{task_id} para el estado de generación. Usa el devuelto para las actualizaciones; las entradas heredadas del Laboratorio sin un proyecto de respaldo usan su ID de ejecución del Laboratorio. devuelve con , , , y .
Idempotencia
Envía Idempotency-Key (de 1 a 200 caracteres) al enviar solicitudes del Laboratorio o de Estudio. La misma cuenta, valor de clave, endpoint y contenido JSON devuelven la tarea original, incluso entre distintas claves de API de esa cuenta. Se ignora el orden de las propiedades del objeto. Reutilizar una clave para contenido distinto devuelve HTTP 409 IDEMPOTENCY_CONFLICT. Si la solicitud original aún se está validando, HTTP 409 REQUEST_IN_PROGRESS te pide que reintentes con la misma clave. Un envío rechazado sigue asociado a su clave; corrígelo usando una clave nueva.
Los índices únicos persistentes evitan que los reintentos simultáneos creen otra generación o reserva. Los registros de idempotencia permanecen con el historial de tareas.
Callbacks firmados
Proporciona un callback_url público opcional. V4V publica task.completed o task.failed con los campos de la tarea, la lista de resultados y event_id estable. Los callbacks tienen las cabeceras X-V4V-Timestamp y X-V4V-Signature: v1=<hex>. Verifícalos usando el secreto de firma del webhook que se mostró cuando se creó la clave de API.
La firma es HMAC-SHA256 sobre la marca de tiempo, un punto literal y el cuerpo bruto exacto de la solicitud. Rechaza las marcas de tiempo antiguas (por ejemplo, de más de cinco minutos) y compara las firmas en tiempo constante.
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'));Devuelve una respuesta 2xx sin demora. La entrega es al menos una vez: elimina duplicados por event_id. Los fallos de red, los tiempos de espera, las respuestas HTTP 408/429 y 5xx se reintentan con retroceso exponencial, empezando en 30 segundos y con un máximo de una hora, hasta 12 intentos por defecto. Otras respuestas no satisfactorias, incluidas las redirecciones, detienen la entrega. Los reintentos nunca crean generaciones ni cobran créditos. Consulta el estado de la tarea si se agota la entrega del callback.
Callbacks por lotes de Studio
POST /studio/batches también acepta un callback_url opcional. Se aplica la misma verificación de callbacks firmados. Los eventos son batch.updated, batch.completed, batch.paused y batch.cancelled, con un event_id estable, batch_id, batch_revision, observed_at, state_token, recuentos y totales de créditos. Lee GET /studio/batches/{batch_id} para obtener los resultados paginados actuales. Los eventos contienen instantáneas compactas en lugar de URL de descarga que caducan; los cambios intermedios pueden agruparse entre ticks del worker.
La entrega es duradera y se reintenta de forma independiente de la generación. Elimina duplicados por event_id y tolera eventos fuera de orden; la entrega repetida conserva el mismo cuerpo. Los receptores lentos o con fallos no crean nuevas generaciones ni bloquean la cola de generación. La cancelación puede emitir una actualización adicional cuando termina el trabajo ya admitido. Un reinicio o retrabajo solicitado más tarde reactiva la supervisión. Un webhook es una integración HTTP y no despierta por sí mismo un chat del navegador ya finalizado.
Errores y límites
Los errores usan un único formato:
{
"error": {
"code": "INVALID_PARAMETER",
"message": "Allowed values: 5, 10.",
"field": "parameters.duration"
}
}HTTP 400/422 indica entrada o parámetros no válidos; 401 una clave no válida/revocada; 402 créditos insuficientes; 403 modelos deshabilitados o acceso denegado; 404 modelos/archivos/tareas no disponibles; 409 un conflicto de idempotencia o una validación en curso; 429 un límite de tasa/concurrencia; 500 un error interno; y 503 indisponibilidad temporal del servicio. Los códigos de error incluyen 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 y SERVICE_UNAVAILABLE. GENERATION_SERVICE_ERROR identifica un error interno notificado del servicio del modelo; no establece que el tamaño de la entrada o los parámetros fueran no válidos. Los ID de archivo inexistentes e inaccesibles comparten una respuesta 404 para evitar revelar archivos de otras cuentas.
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
}
}Para rechazos de ventana de solicitud (antes de la creación de la tarea), espera el retraso indicado y reutiliza la misma clave de idempotencia y los mismos argumentos. Una respuesta que identifica una tarea ya fallida es terminal para esa tarea. Esto no autoriza otro intento de pago después de un fallo terminal de generación.
Generación masiva de Studio (API y MCP)
La generación masiva está disponible a través de la API y de MCP. Todavía no hay un espacio de trabajo masivo en la interfaz de Studio. Envía hasta 300 productos en una solicitud JSON. Cada elemento crea un flujo de trabajo de Studio con su propia tarea, flujo de trabajo/configuración guardados, resultados y contabilización de créditos. La importación de productos y las descargas de referencias se realizan en segundo plano; un elemento no válido falla de forma independiente mientras los elementos restantes continúan.
Studio, LAB, REST, MCP, Shopify y la generación de avatares comparten una cola de servidor persistente con un límite absoluto de 10 solicitudes de generación activas para este despliegue. Esperar un resultado de generación ocupa una plaza. Una generación finalizada libera esa plaza incluso mientras se guarda su archivo. Las solicitudes normales tienen prioridad sobre las solicitudes masivas; lo masivo usa la capacidad disponible, sujeto a los límites globales de masivo y por cuenta de un administrador. Los valores predeterminados son 2 flujos de trabajo masivos simultáneos y 1 por cuenta. Varios lotes pertenecientes a una misma cuenta comparten ese límite. El procesamiento continúa sin un navegador abierto ni sondeo del cliente.
Crear un lote
POST /api/v1/studio/batches — devuelve HTTP 202. Proporciona una cabecera Idempotency-Key obligatoria de 1 a 200 caracteres. Reutiliza la misma clave y un JSON idéntico tras una interrupción de red. Un cuerpo modificado con la misma clave devuelve HTTP 409; la aceptación nunca crea un segundo lote por un reintento.
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 la duración, el formato y la calidad compatibles con el flujo de trabajo actual de Studio de tu despliegue, igual que para POST /api/v1/studio. El ejemplo presupuesta 600 créditos para tres clips Omni de 8 segundos a 720p: 3 × 180 = 540 créditos, dejando 60 créditos de margen. Tres clips de 10 segundos a 720p usan 675 créditos; a 1080p usan 990 y a 4K usan 1.980, antes del precio del vídeo de referencia, pasos adicionales o reintentos. Obtén siempre estimaciones actuales para las entradas exactas antes de elegir un presupuesto de lote.