|API Docs

API Documentation

Automatice su flujo de masterización con la API REST de Masterify. Todas las solicitudes requieren el encabezado .

Base URLhttps://api.masterify.net

REST API · Webhook · Pro o superior

Inicio Rápido

Comience con el Hub de Plantillas

Ofrecemos JSONs iniciales y guías paso a paso para make.com y flujos personalizados con webhook. Descargue un flujo inicial antes de leer los ejemplos de código.

Abrir Hub de Plantillas Ver Plantilla Destacada

Plantillas Incluidas

Detección de subida a Google Drive → Masterización → Entrega por Slack
Lectura de cola de Airtable → Masterización → Actualización de fila
Recopilación de subida por formulario → Masterización → Email al cliente

Autenticación

Todas las solicitudes API requieren autenticación con token Bearer. Las claves API se pueden crear desde la configuración del panel en planes Pro y superiores. Formato de clave: + 32 caracteres hexadecimales.

curl -H "Authorization: Bearer aim_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

Límites de API por plan

Plan	Claves API	Límite de velocidad	Webhooks
free	0	0/min	0
starter	0	0/min	0
pro	5	30/min	3
studio	20	100/min	10

POST/api/v1/master

Crear trabajo de masterización

Suba un archivo de audio y cree un trabajo de masterización. Los archivos deben ser formato MP3/WAV/FLAC, máximo 50MB, 10 minutos o menos.

Cuerpo de solicitudmultipart/form-data

Nombre	Tipo	Obligatorio	Descripción
file	`File`	Yes	Archivo de audio (MP3, WAV, FLAC)
platforms	`string`	Yes	Plataformas separadas por comas: spotify, apple_music, youtube, melon, soundcloud
genre	`string`	No	Género: kpop, edm, ballad, hiphop, pop, other (predeterminado: other)
ai_service	`string`	No	Servicio AI: suno, udio, elevenlabs, other (predeterminado: other)
tier	`string`	No	Nivel de masterización: standard, premium (predeterminado: standard)
webhook_url	`string`	No	URL de callback al completar el trabajo (por trabajo)
reference_file	`File`	No	Pista de referencia (para coincidencia de tono)

Respuesta201

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "platforms": ["spotify", "apple_music"],
  "credits_used": 1,
  "credits_remaining": 19
}

Respuestas de error

Todos los errores se devuelven en el mismo formato:

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "크레딧이 부족합니다."
  }
}

HTTP	Código	Descripción
400	FILE_TOO_LARGE	El archivo supera los 50MB
400	UNSUPPORTED_FORMAT	Solo se admiten MP3, WAV, FLAC
400	FILE_TOO_LONG	El archivo supera los 10 minutos
400	INVALID_PLATFORM	Plataforma no válida
402	INSUFFICIENT_CREDITS	Créditos insuficientes
429	CONCURRENT_LIMIT	Límite de procesamiento simultáneo excedido
401	INVALID_API_KEY	Clave API no válida
429	RATE_LIMIT	Límite de frecuencia excedido

Inicio rápido

Comience su primera masterización en 3 pasos.

Crear clave API

Panel → Configuración → Crear clave API

aim_live_a1b2c3d4...

Solicitar masterización

Subir archivo via POST /api/v1/master

curl -X POST .../v1/master \
  -H "Authorization: Bearer ..." \
  -F "[email protected]" \
  -F "platforms=spotify"

Descargar resultado

Descargar cuando status=done

GET /api/v1/jobs/{id}/download

¿Tiene preguntas? Sección API de la página principal para más información.