RESTful API + Webhooks

Video-Beschreibungs-API für Entwickler

Integrieren Sie KI-gestützte Video-Metadaten-Generierung in Ihre Plattform. Senden Sie Video-URLs, einschließlich HLS-VOD-Manifeste, über die API und erhalten Sie Titel, Beschreibungen und Tags über Webhooks. Analysieren Sie sowohl visuelle Frames als auch Audio-Inhalte. Kostenlose Sandbox zum Testen.

Schritt 1
POST Video-URL
Schritt 2
Asynchrone Verarbeitung
Schritt 3
Webhook empfangen
POST /v1/video-descriptions
sample-video.mp4
00:02:34
vision_audio frames:20
Request
# Job erstellen — Modus vision, vision_audio oder 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
Schritt 1

POST Video-URL

Senden Sie eine POST-Anfrage mit Ihrer Video-URL. Direkte Medienlinks, HLS-VOD-Manifeste oder authentifizierter Zugriff werden unterstützt.

02
Schritt 2

Asynchrone Verarbeitung

Die API extrahiert Frames und Audio, führt KI-Analyse durch. Verfolgen Sie den Status über Job-ID oder warten Sie auf den Webhook.

03
Schritt 3

Webhook empfangen

Erhalten Sie JSON mit Titel, Beschreibung und Tags über HMAC-signierte Webhook-Zustellung.

Descrideo vs. Allzweck-Tools

Wenn Sie verlässliche Video-Metadaten erzeugen wollen, ist ein spezialisierter Workflow meist besser als das Zusammensetzen generischer multimodaler APIs.

Descrideo

Empfohlen für metadata-first Teams
Am besten geeignet für
Asynchrone Video-Beschreibungs-APIs, Webhook-Workflows und Entwicklerportale
Stärke
Speziell für Titel, Beschreibungen, Tags, privaten Videozugriff und webhook-basierte Automatisierung gebaut.
Einschränkungen
Schmalerer Fokus als bei Hyperscalern, aber schnellerer Time-to-Value für genau diesen Use Case.

Google Video AI

Am besten geeignet für
Große Cloud-Ökosysteme und individuelle Media-Intelligence-Pipelines
Stärke
Tiefe Cloud-Integrationen und breites ML-Tooling.
Einschränkungen
Mehr Eigenbau, wenn Sie eigentlich nur produktionsreife Metadaten-Generierung mit Webhooks benötigen.

Cloudinary

Am besten geeignet für
Medienverwaltung, Transformationen und Delivery-Pipelines
Stärke
Starke Asset-Delivery- und Optimierungs-Workflows.
Einschränkungen
Video-SEO-Metadaten sind dort meist nur eine Funktion unter vielen, nicht die Kernoberfläche.

AssemblyAI

Am besten geeignet für
Sprachlastige Medien und transcription-first Produkte
Stärke
Starke Audio- und Transkriptions-Workflows.
Einschränkungen
Für Frame-Analyse, kombinierte Ausgaben und videospezifisches Metadaten-Formatting ist oft zusätzliche Logik nötig.

Warum Entwickler Descrideo API wählen

Enterprise-Grade Video-Beschreibungs-API für Skalierung, Sicherheit und Entwicklererfahrung

Kostenlose Sandbox-Tests

Testen Sie Ihre Integration mit echten Webhook-Zustellungen, keine Videoverarbeitung erforderlich. Kostenloses tägliches Kontingent inklusive.

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

Asynchrone Webhook-Zustellung

Nicht-blockierende API mit HMAC-signierten Webhooks. Automatische Wiederholungen mit exponentiellem Backoff.

Portal-API wartend
Webhook signiert
Ihre App verarbeitet

Flexibler Videozugriff

Direkte Medien-URLs, HLS-VOD-Manifeste, authentifizierter Zugriff oder Source Provider-Muster. Halten Sie Ihre Videos privat.

direct_url
authenticated access
source_provider

Flexible Abrechnung

Prepaid-Token-Guthaben oder Postpaid-Modus. Zahlen Sie nur für erfolgreiche Verarbeitung. Keine versteckten Gebühren.

Prepaid
Token-Guthaben
Postpaid
Zahlung bei Erfolg

Audio-Transkription

Drei Generierungsmodi: nur Vision, kombiniert Vision + Audio oder nur Audio. Nutzen Sie Sprachinhalte für reichhaltigere Beschreibungen.

Enterprise-Sicherheit

SSRF-Schutz, Datenverschlüsselung im Ruhezustand, HMAC-SHA256-Signaturen und Audit-Protokollierung.

Signatur
HMAC-SHA256
Protokollierung
Audit-Trails
Speicher
Privater Zugriff

Einfache REST API

Starten Sie mit nur wenigen Codezeilen

Video-Beschreibungs-Job erstellen
# Job erstellen — Modus vision, vision_audio oder 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"}
  }'
# Antwort: 202 Accepted
{ "job_id": "01HXYZ123ABC", "status": "queued" }

Integrationsmuster für reale Teams

Nutzen Sie dieselbe API aus Backend-Services, Queues, CMS-Workflows oder Low-Code-Automationen.

Python

Python

Starten Sie Jobs aus FastAPI-, Django- oder Flask-Backends und leiten Sie Ergebnisse in Ihr CMS weiter.

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

Hängen Sie die Metadaten-Generierung an Upload-Abschlüsse oder Background-Worker in Ihrem Produkt-Stack.

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

Senden Sie Jobs aus Laravel-Actions, Queue-Jobs oder Admin-Tools und speichern Sie die Job-ID zur späteren Zuordnung.

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

Verbinden Sie Make, Zapier, n8n oder interne Workflow-Runner mit Uploads, Webhooks und Publishing.

1. Neues Video wird in den Storage geladen
2. POST-Request zum Erstellen eines Jobs an Descrideo senden
3. Auf den signierten Webhook-Callback warten
4. Titel, Beschreibung und Tags auslesen
5. Metadaten in CMS, Katalog oder Suchindex übernehmen

Pilot-Ergebnisse aus realen Workflows

Diese Beispiele stehen für interne oder pilotartige Implementierungen und zeigen, welche Effizienz- und Discoverability-Gewinne Teams erwarten können.

Pilotfall 01

UGC-Marktplatz-Ingestion

Herausforderung

Ein Content-Marktplatz brauchte für jedes hochgeladene Video durchsuchbare Titel und Tags noch vor der redaktionellen Prüfung.

Umsetzung

Descrideo wurde nach Upload-Abschluss ausgelöst und lieferte Metadaten asynchron in die Moderationswarteschlange zurück.

  • Die Metadaten-Abdeckung stieg von 18 % auf 92 % bei neu hochgeladenen Videos.
  • Die durchschnittliche manuelle Katalogisierungszeit sank von rund zwei Werktagen auf unter 30 Minuten.
  • Editoren starteten Reviews mit vorbefüllten mehrsprachigen Titeln, Beschreibungen und Tags.
Accessibility-Workflow 02

Barrierefreiheits-Backlog einer Trainingsbibliothek

Herausforderung

Ein internes Lernportal benötigte Entwürfe für Beschreibungen hunderter archivierter Trainingsaufzeichnungen.

Umsetzung

Der Vision+Audio-Modus erzeugte First-Pass-Zusammenfassungen und strukturierte Hinweise für Accessibility-Reviewer.

  • Reviewer reduzierten die Erstfassung von Beschreibungen um rund 60 %.
  • Teams nutzten ein einziges Webhook-Payload, um LMS-Zusammenfassungen und Accessibility-Checklisten zu befüllen.
  • Content-Owner erhielten eine konsistente Metadaten-Basis für ältere Aufzeichnungen.
Katalog-Automatisierung 03

Produktvideo-SEO in großem Maßstab

Herausforderung

Ein E-Commerce-Katalog brauchte konsistente Beschreibungen für Demos, Unboxings und Vergleichsvideos.

Umsetzung

Descrideo erzeugte SEO-fähige Texte, die Merchandising-Teams vor der Veröffentlichung auf Produktseiten prüften.

  • Publishing-Teams reduzierten die Texterstellung pro Launch-Batch von Stunden auf Minuten.
  • SEO-Teams erhielten strukturierte Tags und VideoObject-fähige Felder für Produktseiten.
  • Merchandiser hielten den Brand-Ton durch Custom Instructions pro Batch konsistent.
POST /v1/video-descriptions

Beginnen Sie mit der Descrideo API

Holen Sie sich Ihren API-Schlüssel und starten Sie Tests mit unserer kostenlosen Sandbox. Keine Kreditkarte erforderlich.