API RESTful + Webhooks

API de Descripción de Video para Desarrolladores

Integra la generación automatizada de metadatos de video con IA en tu plataforma. Envía URLs de video, incluidos manifiestos HLS VOD, vía API y recibe títulos, descripciones y etiquetas vía webhooks. Analiza tanto fotogramas visuales como contenido de audio. Sandbox gratuito para pruebas.

Paso 1
POST URL de Video
Paso 2
Procesamiento Asíncrono
Paso 3
Recibir Webhook
POST /v1/video-descriptions
sample-video.mp4
00:02:34
vision_audio frames:20
Request
# Crear un trabajo — modo vision, vision_audio o audio
curl -X POST https://api.descrideo.com/v1/video-descriptions
-H "X-API-Key: YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"source":{"type":"direct_url"}}'
202 Accepted
{
  "job_id": "01HXYZ123ABC",
  "status": "queued",
  "delivery": "webhook"
}
01
Paso 1

POST URL de Video

Envía una solicitud POST con tu URL de video. Se admiten enlaces multimedia directos, manifiestos HLS VOD o acceso autenticado.

02
Paso 2

Procesamiento Asíncrono

La API extrae fotogramas y audio, ejecuta análisis IA. Rastrea el estado vía ID del trabajo o espera el webhook.

03
Paso 3

Recibir Webhook

Obtén JSON con título, descripción y etiquetas vía entrega webhook firmada con HMAC.

Descrideo vs herramientas de propósito general

Si tu objetivo es generar metadatos de video fiables, un flujo especializado suele funcionar mejor que ensamblar APIs multimodales genéricas.

Descrideo

Recomendado para equipos centrados en metadatos
Mejor para
APIs asíncronas de descripción de video, flujos con webhook y portales para desarrolladores
Fortaleza
Diseñado específicamente para títulos, descripciones, etiquetas, acceso privado a videos y automatización orientada a webhooks.
Compromisos
Tiene un alcance más estrecho que los hyperscalers, pero ofrece valor más rápido para este caso de uso concreto.

Google Video AI

Mejor para
Grandes ecosistemas cloud y pipelines personalizados de inteligencia multimedia
Fortaleza
Integraciones cloud profundas y un ecosistema amplio de herramientas ML.
Compromisos
Requiere más ensamblaje si solo necesitas generación de metadatos lista para producción con webhooks.

Cloudinary

Mejor para
Gestión de medios, transformaciones y delivery
Fortaleza
Muy buenos flujos para entrega y optimización de assets.
Compromisos
La generación de metadatos SEO de video suele ser una capacidad más, no la superficie principal del producto.

AssemblyAI

Mejor para
Productos centrados en voz y flujos transcription-first
Fortaleza
Excelente en audio y transcripción.
Compromisos
A menudo necesitarás lógica adicional para análisis de fotogramas, salidas combinadas y formateo específico para video.

Por Qué los Desarrolladores Eligen API Descrideo

API de descripción de video de nivel empresarial diseñada para escala, seguridad y experiencia del desarrollador

Pruebas Gratuitas en Sandbox

Prueba tu integración con entregas webhook reales, sin procesamiento de video requerido. Cuota diaria gratuita incluida.

Sandbox
$ curl https://api.descrideo.com/v1/video-descriptions
-H "Authorization: Bearer nxt_test_key"
# webhook delivery without full production wiring

Entrega Webhook Asíncrona

API no bloqueante con webhooks firmados HMAC. Reintentos automáticos con backoff exponencial.

API del portal en cola
Webhook firmado
Tu aplicación procesado

Acceso Flexible a Videos

URLs multimedia directas, manifiestos HLS VOD, acceso autenticado o patrón Source Provider. Mantén tus videos privados.

direct_url
authenticated access
source_provider

Facturación Flexible

Saldo de tokens prepago o modo pospago. Paga solo por procesamiento exitoso. Sin tarifas ocultas.

Prepago
Saldo de tokens
Pospago
Pago por éxito

Transcripción de Audio

Tres modos de generación: solo visión, visión + audio combinados, o solo audio. Aprovecha el contenido de voz para descripciones más ricas.

Seguridad Empresarial

Protección SSRF, cifrado de datos en reposo, firmas HMAC-SHA256 y registro de auditoría.

Firma
HMAC-SHA256
Registro
Pistas de auditoría
Almacenamiento
Acceso privado

API REST Simple

Comienza con solo unas pocas líneas de código

Crear Trabajo de Descripción de Video
# Crear un trabajo — modo vision, vision_audio o audio
curl -X POST https://api.descrideo.com/v1/video-descriptions \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": {
      "type": "direct_url",
      "url": "https://example.com/video.mp4"
    },
    "frames": 20,
    "generation_mode": "vision_audio",
    "webhook": {"url": "https://your-app.com/webhooks/video"}
  }'
# Respuesta: 202 Accepted
{ "job_id": "01HXYZ123ABC", "status": "queued" }

Recetas de integración para equipos reales

Usa la misma API desde servicios backend, colas, flujos CMS o herramientas low-code.

Python

Python

Lanza trabajos desde backends FastAPI, Django o Flask y envía los resultados a tu CMS.

import requests

payload = {
    'source': {'type': 'direct_url', 'url': 'https://example.com/video.mp4'},
    'frames': 20,
    'generation_mode': 'vision_audio',
    'webhook': {'url': 'https://app.example.com/webhooks/descriptions'},
}

response = requests.post(
    'https://api.descrideo.com/v1/video-descriptions',
    headers={'Authorization': 'Bearer nxt_live_key'},
    json=payload,
    timeout=30,
)

Node.js

Node.js

Conecta la generación de metadatos a eventos de subida completada o workers en segundo plano.

const response = await fetch('https://api.descrideo.com/v1/video-descriptions', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer nxt_live_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    source: { type: 'direct_url', url: 'https://example.com/demo.mp4' },
    frames: 30,
    generation_mode: 'vision',
    webhook: { url: 'https://app.example.com/webhooks/descriptions' },
  }),
})

PHP

PHP

Envía trabajos desde acciones de Laravel, jobs en cola o herramientas admin y guarda el job ID para conciliación.

use Illuminate\Support\Facades\Http;

$response = Http::withToken('nxt_live_key')
    ->post('https://api.descrideo.com/v1/video-descriptions', [
        'source' => ['type' => 'source_provider', 'provider' => ['asset_id' => 'video_123']],
        'frames' => 20,
        'generation_mode' => 'vision_audio',
        'webhook' => ['url' => 'https://app.example.com/webhooks/descriptions'],
    ]);

No-code

No-code

Usa Make, Zapier, n8n o un runner interno para encadenar subidas, webhooks y publicación.

1. Se sube un nuevo video al storage
2. Envía un POST de create-job a Descrideo
3. Espera el callback webhook firmado
4. Procesa título, descripción y etiquetas
5. Publica los metadatos en el CMS, catálogo o índice de búsqueda

Resultados piloto de flujos reales

Estos ejemplos representan implementaciones internas o piloto y muestran el tipo de mejoras de eficiencia y descubrimiento que los equipos pueden esperar.

Caso piloto 01

Ingesta en marketplace UGC

Reto

Un marketplace de contenido necesitaba que cada video subido llegara con títulos y etiquetas buscables antes de la revisión editorial.

Implementación

Descrideo se activó al finalizar la subida y devolvió metadatos de forma asíncrona a la cola de moderación.

  • La cobertura de metadatos subió del 18% al 92% en los videos recién cargados.
  • El tiempo medio de catalogación manual bajó de unos 2 días laborables a menos de 30 minutos.
  • Los editores empezaron la revisión con títulos, descripciones y etiquetas multilingües ya rellenados.
Flujo de accesibilidad 02

Backlog de accesibilidad en biblioteca de formación

Reto

Un portal interno de aprendizaje necesitaba borradores de descripción para cientos de grabaciones formativas archivadas.

Implementación

El modo visión + audio generó resúmenes iniciales y notas estructuradas para los equipos de revisión de accesibilidad.

  • Los revisores redujeron alrededor de un 60% el tiempo de redacción inicial.
  • Los equipos usaron un único payload webhook para completar resúmenes LMS y checklists de accesibilidad.
  • Los responsables de contenido obtuvieron una base consistente de metadatos para grabaciones antiguas.
Automatización de catálogo 03

SEO de video de producto a escala

Reto

Un catálogo e-commerce necesitaba descripciones consistentes para demos, unboxings y videos comparativos.

Implementación

Descrideo generó copy preparado para SEO que los equipos de merchandising revisaban antes de publicarlo en páginas de producto.

  • Los equipos de publicación redujeron la creación de textos de horas a minutos por lote.
  • Los equipos de búsqueda recibieron etiquetas estructuradas y campos listos para VideoObject.
  • Merchandising mantuvo el tono de marca mediante instrucciones personalizadas por lote.
POST /v1/video-descriptions

Comienza a Construir con API Descrideo

Obtén tu clave API y comienza a probar con nuestro sandbox gratuito. No se requiere tarjeta de crédito.