RESTful API + Webhooks

Video Description
API for Developers

Integrate AI-powered video metadata generation into your platform. Submit video URLs via API, receive titles, descriptions, and tags via webhooks. Analyze both visual frames and audio content. Free sandbox for testing.

View API Docs View Pricing

Step 1

POST Video URL

Send a POST request with your video URL. Direct links or authenticated access supported.

Step 2

Async Processing

API extracts frames and audio, runs AI analysis. Track status via job ID or wait for webhook.

Step 3

Receive Webhook

Get JSON with title, description, and tags via HMAC-signed webhook delivery.

Why Developers Choose Descrideo API

Enterprise-grade video description API built for scale, security, and developer experience

Free Sandbox Testing

Test your integration with real webhook deliveries, no video processing required. Free daily quota included.

Async Webhook Delivery

Non-blocking API with HMAC-signed webhooks. Automatic retries with exponential backoff.

Flexible Video Access

Direct URLs, authenticated access, or Source Provider pattern. Keep your videos private.

Flexible Billing

Prepaid token balance or postpaid mode. Pay only for successful processing. No hidden fees.

Audio Transcription

Three generation modes: vision-only, combined vision + audio, or audio-only. Leverage speech content for richer descriptions.

Enterprise Security

SSRF protection, data encryption at rest, HMAC-SHA256 signatures, and audit logging.

Simple REST API

Get started with just a few lines of code

Create Video Description Job

# Create a job — vision, vision_audio, or audio mode
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",
    "transcription": {
      "segments": 10,
      "segment_sec": 30
    },
    "webhook": {
      "url": "https://your-app.com/webhooks/video"
    },
    "client_context": {
      "lang": "en",
      "output_fields": ["title", "description", "tags"]
    }
  }'

# Response: 202 Accepted
{
  "job_id": "01HXYZ123ABC",
  "status": "queued"
}

View full API documentation