Enterprise-grade video description API built for scale, security, and developer experience
Test your integration with real webhook deliveries, no video processing required. Free daily quota included.
Non-blocking API with HMAC-signed webhooks. Automatic retries with exponential backoff.
Direct URLs, authenticated access, or Source Provider pattern. Keep your videos private.
Prepaid token balance or postpaid mode. Pay only for successful processing. No hidden fees.
Three generation modes: vision-only, combined vision + audio, or audio-only. Leverage speech content for richer descriptions.
SSRF protection, data encryption at rest, HMAC-SHA256 signatures, and audit logging.
When your goal is reliable video metadata generation, purpose-built workflow beats stitching together generic multimodal APIs.
| Platform | Best for | Strength | Trade-offs |
|---|---|---|---|
|
Descrideo
Recommended for metadata-first teams
|
Async video description APIs, webhook workflows, and developer portals | Built specifically for titles, descriptions, tags, private video access, and webhook-first automation. | Narrower scope than hyperscalers, but faster time-to-value for this exact use case. |
|
Google Video AI
|
Large cloud ecosystems and custom media intelligence pipelines | Deep cloud integrations and broad ML tooling. | More assembly work when all you need is production-ready metadata generation with webhooks. |
|
Cloudinary
|
Media management, transformations, and delivery pipelines | Excellent asset delivery and optimization workflows. | Video SEO metadata generation is usually one capability among many, not the core product surface. |
|
AssemblyAI
|
Speech-heavy media and transcription-first products | Strong audio and transcription workflows. | You may still need extra logic for frame analysis, combined outputs, and video-specific metadata formatting. |
Get started with just a few lines of code
# 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"
}Use the same API from backend services, queues, CMS workflows, or low-code automation tools.
Queue a job from a FastAPI, Django, or Flask backend and forward results into your 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,
)Attach metadata generation to upload completion events or background workers in your product 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' },
}),
})Send jobs from Laravel actions, queued jobs, or admin tools and store the returned job ID for reconciliation.
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'],
]);Use Make, Zapier, n8n, or an internal workflow runner to chain uploads, webhooks, and content publishing.
1. New video uploaded to storage
2. POST create-job request to Descrideo
3. Wait for signed webhook callback
4. Parse title, description, and tags
5. Push metadata into CMS, catalog, or search indexFrom video platforms to accessibility workflows, our API powers diverse applications
These are representative internal and pilot-style implementations showing the kind of throughput and discoverability gains teams can expect.
Challenge: A content marketplace needed every uploaded video to ship with searchable titles and tags before editorial review.
Implementation: Descrideo was triggered after upload completion and returned metadata asynchronously into the moderation queue.
Challenge: An internal learning portal needed draft descriptions for hundreds of archived training recordings.
Implementation: Vision + audio mode generated first-pass summaries and structured notes for accessibility review teams.
Challenge: An ecommerce catalog needed consistent descriptions for demo clips, unboxings, and comparison videos.
Implementation: Descrideo generated SEO-ready copy that merchandising teams reviewed before publishing to product pages.
Get your API key and start testing with our free sandbox. No credit card required.