API RESTful + Webhooks

API de Description Vidéo pour Développeurs

Intégrez la génération automatique de métadonnées vidéo par IA dans votre plateforme. Soumettez des URL vidéo, y compris des manifestes HLS VOD, via API et recevez titres, descriptions et tags via webhooks. Analysez les images et le contenu audio. Bac à sable gratuit pour les tests.

Étape 1
POST URL Vidéo
Étape 2
Traitement Asynchrone
Étape 3
Recevoir le Webhook
POST /v1/video-descriptions
sample-video.mp4
00:02:34
vision_audio frames:20
Request
# Créer une tâche — mode vision, vision_audio ou 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
Étape 1

POST URL Vidéo

Envoyez une requête POST avec votre URL vidéo. Liens médias directs, manifestes HLS VOD ou accès authentifié sont pris en charge.

02
Étape 2

Traitement Asynchrone

L'API extrait les images et l'audio, effectue l'analyse IA. Suivez l'état via l'ID du job ou attendez le webhook.

03
Étape 3

Recevoir le Webhook

Obtenez un JSON avec titre, description et tags via livraison webhook signée HMAC.

Descrideo vs outils généralistes

Quand votre objectif est de générer des métadonnées vidéo fiables, un workflow spécialisé est souvent plus efficace qu’un assemblage d’API multimodales génériques.

Descrideo

Recommandé pour les équipes centrées sur les métadonnées
Idéal pour
APIs asynchrones de description vidéo, workflows webhook et portails développeurs
Point fort
Pensé spécifiquement pour les titres, descriptions, tags, accès privé aux vidéos et automatisation orientée webhook.
Compromis
Portée plus étroite que les hyperscalers, mais un time-to-value plus rapide pour ce cas d’usage précis.

Google Video AI

Idéal pour
Grands écosystèmes cloud et pipelines media intelligence sur mesure
Point fort
Intégrations cloud profondes et large éventail d’outils ML.
Compromis
Demande davantage d’assemblage si vous voulez surtout une génération de métadonnées prête pour la production avec webhooks.

Cloudinary

Idéal pour
Gestion média, transformations et delivery
Point fort
Très bons workflows de diffusion et d’optimisation des assets.
Compromis
Les métadonnées SEO vidéo y sont souvent une fonctionnalité parmi d’autres, pas le cœur du produit.

AssemblyAI

Idéal pour
Produits orientés voix et workflows transcription-first
Point fort
Très fort sur l’audio et la transcription.
Compromis
Il faut souvent ajouter de la logique pour l’analyse d’images, les sorties combinées et le formatage vidéo spécifique.

Pourquoi les Développeurs Choisissent l'API Descrideo

API de description vidéo de qualité entreprise conçue pour l'évolutivité, la sécurité et l'expérience développeur

Tests Gratuits en Bac à Sable

Testez votre intégration avec de vraies livraisons webhook, sans traitement vidéo requis. Quota quotidien gratuit inclus.

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

Livraison Webhook Asynchrone

API non-bloquante avec webhooks signés HMAC. Tentatives automatiques avec backoff exponentiel.

API du portail en file
Webhook signé
Votre application traité

Accès Vidéo Flexible

URL médias directes, manifestes HLS VOD, accès authentifié ou pattern Source Provider. Gardez vos vidéos privées.

direct_url
authenticated access
source_provider

Facturation Flexible

Solde de jetons prépayé ou mode postpayé. Payez uniquement pour le traitement réussi. Pas de frais cachés.

Prépayé
Solde de jetons
Postpayé
Paiement au succès

Transcription Audio

Trois modes de génération : vision seule, vision + audio combinés, ou audio seul. Exploitez le contenu vocal pour des descriptions plus riches.

Sécurité Entreprise

Protection SSRF, chiffrement des données au repos, signatures HMAC-SHA256 et journalisation d'audit.

Signature
HMAC-SHA256
Journalisation
Pistes d'audit
Stockage
Accès privé

API REST Simple

Démarrez avec seulement quelques lignes de code

Créer une tâche de description vidéo
# Créer une tâche — mode vision, vision_audio ou 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"}
  }'
# Réponse : 202 Accepted
{ "job_id": "01HXYZ123ABC", "status": "queued" }

Recettes d’intégration pour des équipes réelles

Utilisez la même API depuis vos services backend, vos files d’attente, vos workflows CMS ou vos outils low-code.

Python

Python

Lancez des jobs depuis un backend FastAPI, Django ou Flask et renvoyez les résultats dans votre 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

Rattachez la génération de métadonnées à la fin d’un upload ou à des workers en arrière-plan.

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

Envoyez des jobs depuis des actions Laravel, des jobs en file ou des outils admin, puis stockez le job ID pour le suivi.

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

Utilisez Make, Zapier, n8n ou un orchestrateur interne pour chaîner uploads, webhooks et publication.

1. Une nouvelle vidéo est déposée dans le stockage
2. Envoyez la requête POST create-job à Descrideo
3. Attendez le callback webhook signé
4. Récupérez le titre, la description et les tags
5. Publiez les métadonnées dans le CMS, le catalogue ou l’index de recherche

Résultats pilotes issus de workflows réels

Ces exemples représentent des implémentations internes ou pilotes et montrent les gains d’efficacité et de découvrabilité que des équipes peuvent attendre.

Cas pilote 01

Ingestion d’un marketplace UGC

Enjeu

Une place de marché de contenus devait publier chaque vidéo uploadée avec des titres et tags recherchables avant revue éditoriale.

Mise en œuvre

Descrideo était déclenché à la fin de l’upload et renvoyait les métadonnées de façon asynchrone vers la file de modération.

  • La couverture en métadonnées est passée de 18 % à 92 % sur les nouvelles vidéos.
  • Le temps moyen de catalogage manuel est tombé d’environ 2 jours ouvrés à moins de 30 minutes.
  • Les éditeurs démarraient la revue avec des titres, descriptions et tags multilingues déjà préremplis.
Workflow accessibilité 02

Backlog accessibilité d’une bibliothèque de formation

Enjeu

Un portail de learning interne avait besoin de brouillons de descriptions pour des centaines d’enregistrements archivés.

Mise en œuvre

Le mode vision + audio a généré des résumés initiaux et des notes structurées pour les équipes de revue accessibilité.

  • Les relecteurs ont réduit d’environ 60 % le temps de rédaction du premier jet.
  • Les équipes ont utilisé un unique payload webhook pour alimenter résumés LMS et checklists accessibilité.
  • Les owners de contenu ont obtenu une base cohérente de métadonnées sur les anciens enregistrements.
Automatisation catalogue 03

SEO vidéo produit à grande échelle

Enjeu

Un catalogue e-commerce avait besoin de descriptions cohérentes pour des démos, unboxings et vidéos comparatives.

Mise en œuvre

Descrideo générait des textes prêts pour le SEO, relus ensuite par les équipes merchandising avant publication.

  • Les équipes de publication ont réduit la création de copy de plusieurs heures à quelques minutes par batch.
  • Les équipes search recevaient des tags structurés et des champs prêts pour VideoObject.
  • Le merchandising conservait le ton de marque grâce à des custom instructions par lot.
POST /v1/video-descriptions

Commencez à Développer avec l'API Descrideo

Obtenez votre clé API et commencez les tests avec notre bac à sable gratuit. Aucune carte de crédit requise.