Presentamos la API para Desarrolladores de ClipMixAI

Hoy abrimos los motores que impulsan la aplicación web de ClipMixAI a cualquiera que quiera construir sobre ellos. La nueva API para Desarrolladores en api.clipmixai.com/api/v1 expone cuatro servicios —traducción de vídeo, vídeo de recuerdos, faceswap y avatares, y música con IA— a través de una única superficie REST con autenticación Bearer. Los mismos modelos, la misma calidad, los mismos créditos. Sin suscripción. Sin mínimos.

Si prefieres saltarte la explicación: /api tiene el resumen de producto, /api/docs tiene la referencia completa, y /dashboard/api-keys es donde creas tu clave.

Por qué la hemos construido

Durante el último año hemos visto a usuarios de pago hacer exactamente lo mismo una y otra vez: abrir el panel, subir 30 fotos, hacer clic en crear, esperar la canción y luego llevar el resultado manualmente a otra herramienta de edición. Había fundadores traduciendo contenido de creadores a 10 idiomas, agencias produciendo 100 spots de marca a la semana, estudios indie de videojuegos generando música temporal para prototipos. Todos y cada uno de ellos acababan haciendo la misma pregunta: "¿hay una API?"

Ahora la hay. Los cuatro servicios que impulsaban todos esos flujos de trabajo son ahora accesibles desde tu código —sin pasar por el panel, sin necesidad de aprenderte las particularidades de cada proveedor, y con el mismo precio por crédito que ya conoces de la aplicación web. Si un flujo que antes le llevaba a una persona una hora ahora puede ejecutarse desde un CRON job en segundo plano, eso es la victoria.

Inicio rápido

Genera una clave desde el panel y luego:

curl -X POST https://api.clipmixai.com/api/v1/music \
  -H "Authorization: Bearer sk_live_..." \
  -H "Idempotency-Key: my-fresh-key-1" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt":   "Uplifting synthwave with female vocals",
    "lyrics":   "[verse]\nRunning through neon lights...",
    "duration_seconds": 60
  }'

Recibes un job-id al instante con status: "processing". Puedes hacer polling en GET /v1/music/{id} hasta que el estado cambie a completed, o —mejor aún— asociar un webhook a tu clave al crearla, y nosotros haremos un POST del resultado terminado a tu endpoint, firmado con HMAC-SHA256 para que puedas verificar que viene de nosotros.

Tres cosas que los desarrolladores pedían y que antes no ofrecíamos

1. Claves de sandbox

Cada clave de API tiene un modo: sk_live_ consume créditos y llama a los proveedores reales; sk_test_ nunca cobra, nunca llama a ningún proveedor y devuelve un trabajo sintético completed con test: true en el cuerpo. Usa claves de sandbox en tu CI para verificar la integración sin gastar créditos, y cambia a claves en producción cuando quieras resultados reales.

Las claves de sandbox son gratuitas para todos, incluso para cuentas en el nivel gratuito. El único requisito para usar una clave en producción es haber realizado al menos una compra de créditos, lo que sitúa el acceso a la API detrás de la misma señal de pago que la aplicación web.

2. Idempotency-Key en cada POST

Los reintentos de red son la pesadilla de cualquier API donde se cobra por uso. Tomamos prestada la solución de Stripe: pasa Idempotency-Key: <tu-cadena> en cualquier llamada de creación y el servidor almacena la respuesta en caché durante 24 horas. Un reintento con la misma clave y el mismo cuerpo devuelve la respuesta original, sin cobrar dos veces. Un reintento con la misma clave pero un cuerpo diferente devuelve 422 idempotency_key_reuse para que detectes el error en lugar de generar silenciosamente el trabajo equivocado.

Ambos SDKs oficiales exponen esto como un único argumento con nombre:

# Python
c.music.create(prompt=..., lyrics=..., idempotency_key="order-42")

// JS
await c.music.create({ prompt, lyrics, idempotencyKey: "order-42" });

3. Webhooks con botón para pruebas

Configura una URL de callback en tu clave y haremos un POST con los eventos job.completed / job.failed según los trabajos vayan terminando. Cada entrega incluye una firma HMAC en X-ClipMix-Signature: sha256=<hex> — verifica con un helper de cualquiera de los dos SDKs. Las entregas fallidas se reintentan con retroceso exponencial (0s → 30s → 5m → 1h, cuatro intentos en total).

El panel tiene un botón Enviar prueba que manda un evento sintético webhook.test para que puedas verificar la firma y el parseo de tu endpoint sin esperar a un trabajo real. El mismo panel muestra un registro de las últimas 100 entregas por clave, así que cuando algo falla no tienes que adivinar dónde se rompió.

Tres casos de uso que ya estamos viendo

Traducción masiva de vídeos para creadores

Sube un vídeo y obtén 10 versiones dobladas en 10 idiomas, con clonación de voz opcional que preserva el tono del hablante. Ya tenemos a un creador de YouTube traduciendo su podcast semanal a 9 idiomas en piloto automático: la llamada a la API se dispara desde su hook de publicación existente y el webhook deposita el archivo doblado directamente en su CMS.

Vídeos de marca personalizados por cliente

La generación de vídeo a partir de fotos permite que una tienda de comercio electrónico tome la foto de un producto de un cliente y genere un breve anuncio cinematográfico personalizado para ese artículo. El endpoint family-videos expone los cuatro modos (Moment, Story, Album, Chronicle) que construimos para nuestra interfaz de consumidor; las agencias los están usando como motor dentro de herramientas de marca blanca.

Prototipado de audio para videojuegos

Estudios indie están llamando al endpoint /v1/music desde dentro de su pipeline interno de assets. Un diseñador de juegos escribe un estado de ánimo y un fragmento de letra provisional, y diez minutos después una pista de 60 segundos aparece en la carpeta de audio del proyecto. Iteran sobre música temporal en segundos en lugar de esperar al diseñador de sonido para cada variación.

Versionado y a qué nos comprometemos

v1 es estable. No introduciremos cambios que rompan la compatibilidad dentro de /api/v1/ — los nuevos campos y endpoints son siempre aditivos y la superficie existente permanece intacta. Cualquier cambio que obliguemos a hacer (algo poco frecuente) se publicará bajo /api/v2/ con un período de transición anunciado. El registro de cambios es la fuente de verdad.

El estado operativo está disponible en /api/status — un resumen de salud por servicio basado en el tráfico real de los últimos 5 minutos. Se actualiza cada 60 segundos y es la misma vista que consulta nuestro equipo de guardia.

Precios

El mismo monedero que la aplicación web. $1 = 100 créditos, con los bonos por volumen existentes en las recargas. Una canción de 60 segundos cuesta 60 créditos ($0.60). Un avatar parlante de 30 segundos en el nivel equilibrado cuesta 450 créditos. Traducir un vídeo de 1 minuto en el nivel premium cuesta ~190 créditos. Las claves de sandbox son gratuitas.

Los planes de API por niveles (Pro / Business / Enterprise) con descuentos por volumen y trabajadores prioritarios están en camino. Si hoy ya necesitas eso, déjanos tu correo en /contact?topic=api-tiers y te avisaremos cuando estén disponibles.

Pruébalo

• /api — presentación en cinco minutos
• /api/docs — referencia completa (autenticación, idempotencia, webhooks, sandbox, errores, SDKs)
• /api/status — estado del servicio en tiempo real
• /api/changelog — qué se ha publicado y qué viene
• /dashboard/api-keys — genera tu primera clave

Informes de errores y peticiones de nuevas funciones: GitHub Issues. Cualquier otra consulta: support@clipmixai.com.