Referencia de la API

Qué es la API

La API de MyDreamVid permite que tu propio software genere videos e imágenes con los modelos Seedance y Seedream, sin que nadie tenga que usar el estudio. Tu programa envía un prompt (y archivos de referencia opcionales), nosotros aplicamos las mismas comprobaciones de seguridad y los mismos precios que el estudio web, y tu programa recoge el archivo terminado. Los créditos se descuentan del mismo saldo de tu cuenta.

Para quién es

• Equipos que generan en volumen: catálogos de producto, variantes de anuncios, clips para redes, versiones localizadas de un mismo video.
• Desarrolladores que añaden generación de video o imágenes a su propia app, herramienta, bot o pipeline interno.
• Agencias y estudios que quieren su propio front end mientras nosotros nos ocupamos de los modelos, las colas y la facturación.

Si haces unos pocos videos a la semana a mano, no necesitas la API. El estudio hace todo lo que hace la API, con los mismos precios.

Autenticación

Cada solicitud lleva una clave bearer. Las claves se crean en el estudio y se muestran una sola vez.

• Cabecera: Authorization: Bearer mdv_live_…
• El permiso write puede crear y cancelar tareas y subir archivos; read solo puede listar y consultar.
• Las claves están disponibles tras una recarga Creator ($25) o Studio ($50). Los créditos nunca caducan.
• La API está pensada para llamarse desde tu servidor. No incluyas claves en código de navegador o móvil.

Conoce el precio primero

Cada tarea cuesta créditos (1 crédito = $0.01). Pide una cotización antes de crear: es gratis, no necesita Idempotency-Key y devuelve exactamente lo que la tarea reservará. El mismo número vuelve como credits_reserved al crear la tarea, y credits_charged en la tarea terminada es lo que realmente pagaste (cualquier parte no usada de la reserva se devuelve).

GET /v1/credits muestra tu saldo disponible y reservado en cualquier momento. Las tareas creadas a través de la API también aparecen en el estudio, en Mis creaciones y en el historial de Créditos.

Endpoints

• GET /v1/models — Modelos con duraciones, resoluciones, relaciones, precios en créditos por segundo y límites de referencias.
• POST /v1/videos/quote — Costo exacto en créditos de una tarea. Gratis, sin reserva.
• POST /v1/videos — Crea una tarea. Body: kind (t2v | i2v | r2v), model, prompt, duration_s, resolution, ratio, generate_audio opcional, references. Requiere Idempotency-Key.
• GET /v1/videos/{id} — Estado de la tarea; una tarea succeeded incluye video_url.
• GET /v1/videos — Tus tareas, de la más reciente a la más antigua, paginadas por cursor (limit, cursor).
• POST /v1/videos/{id}/cancel — Cancela una tarea en estado waiting o queued.
• POST /v1/files/presign — Hueco de subida para una imagen, un video o un archivo de audio de referencia.
• POST /v1/files/{media_id}/confirm — Finaliza una subida: el archivo se analiza y pasa la comprobación de seguridad, y queda usable como referencia.
• GET /v1/credits — Créditos disponibles y reservados.

Límites

• 60 solicitudes por minuto por clave.
• 2 tareas en curso (waiting, queued o running) por cuenta a través de la API.
• Los carriles por modelo se comparten entre todos; cuando un carril está lleno tu tarea espera en orden y se envía automáticamente.
• Hasta 5 claves activas por cuenta.
• Archivos: imágenes hasta 10 MB, video hasta 50 MB, audio hasta 20 MB. Los videos de referencia deben durar al menos 2 segundos; el video y el audio pueden durar como máximo 5 minutos.