01
第一步
POST 提交视频 URL
发送带有视频 URL 的 POST 请求。支持直接媒体链接、HLS VOD 清单或经过身份验证的访问。
RESTful API + Webhooks
视频描述 面向开发者的 API
将 AI 驱动的视频元数据生成集成到您的平台中。通过 API 提交视频 URL（包括 HLS VOD 清单），并通过 webhook 接收标题、描述和标签。全面分析视觉帧和音频内容。免费沙盒测试环境。
第一步
POST 提交视频 URL
第二步
异步处理
第三步
接收 Webhook
sample-video.mp4
00:02:34
vision_audio
frames:20
Request
# 创建任务 — vision、vision_audio 或 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"
}
02
第二步
异步处理
API 提取帧和音频并运行 AI 分析。通过任务 ID 跟踪状态或等待 webhook 回调。
03
第三步
接收 Webhook
通过带 HMAC 签名的 webhook 获取包含标题、描述和标签的 JSON 数据。
Descrideo 对比 通用型工具
如果你的目标是稳定地产出视频元数据，那么面向该场景的专用工作流通常优于拼装通用多模态 API。
Descrideo
适合以元数据为核心的团队- 最适合
- 异步视频描述 API、Webhook 工作流以及开发者门户
- 优势
- 专为标题、描述、标签、私有视频访问以及 webhook 驱动自动化而设计。
- 取舍
- 范围比超大云平台更聚焦，但在这一具体用例上更快落地。
Google Video AI
- 最适合
- 大型云生态和定制化媒体智能流水线
- 优势
- 云集成能力强，机器学习工具链丰富。
- 取舍
- 如果你只想要带 webhook 的生产级元数据生成，往往需要额外拼装。
Cloudinary
- 最适合
- 媒体管理、转换和交付流程
- 优势
- 资源交付与优化工作流非常成熟。
- 取舍
- 视频 SEO 元数据通常只是众多能力中的一个，不是核心产品面。
AssemblyAI
- 最适合
- 以语音为主的媒体产品和 transcription-first 场景
- 优势
- 音频和转录能力很强。
- 取舍
- 在帧分析、组合输出以及视频专用元数据格式上通常还需要额外逻辑。
开发者选择 Descrideo API
专为规模化、安全性和开发体验而打造的企业级视频描述 API
免费沙盒测试
使用真实的 webhook 交付测试您的集成，无需处理视频。包含每日免费配额。
$ curl https://api.descrideo.com/v1/video-descriptions
-H "Authorization: Bearer nxt_test_key"
# webhook delivery without full production wiring
异步 Webhook 交付
带 HMAC 签名的非阻塞 API，支持指数退避的自动重试。
门户 API
已排队
Webhook
已签名
你的应用
已处理
灵活的视频访问
支持直接媒体 URL、HLS VOD 清单、身份验证访问或 Source Provider 模式。保护您的视频隐私。
direct_url
authenticated access
source_provider
灵活计费
预付代币余额或后付费模式。仅为成功处理付费，无隐藏费用。
预付费
令牌余额
后付费
成功后计费
音频转录
三种生成模式：纯视觉、视觉+音频组合、或纯音频。利用语音内容获取更丰富的描述。
企业级安全
SSRF 防护、静态数据加密、HMAC-SHA256 签名和审计日志。
签名
HMAC-SHA256
日志
审计轨迹
存储
私有访问
# 创建任务 — vision、vision_audio 或 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"}
}'
# 响应：202 Accepted
{ "job_id": "01HXYZ123ABC", "status": "queued" }
适用于 真实团队的集成方式
同一套 API 可以用于后端服务、队列任务、CMS 工作流或低代码自动化工具。
Python
Python从 FastAPI、Django 或 Flask 后端发起任务，并把结果回写到 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把元数据生成接到上传完成事件或后台 worker 上。
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从 Laravel action、队列任务或后台工具中发送任务，并保存 job ID 用于后续对账。
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使用 Make、Zapier、n8n 或内部工作流引擎串联上传、webhook 和发布。
1. 新视频上传到存储
2. 向 Descrideo 发送 create-job POST 请求
3. 等待签名 webhook 回调
4. 解析标题、描述和标签
5. 将元数据写入 CMS、目录或搜索索引适用于 各种场景
从视频平台到无障碍工作流，我们的 API 支持各种应用
来自 真实工作流的试点结果
这些示例代表内部或试点式落地场景，展示了团队通常可以获得的效率和可发现性提升。
试点案例
01
UGC 内容市场入库
挑战
一个内容市场希望每个上传视频在进入编辑审核前就具备可搜索的标题和标签。
实施方式
上传完成后触发 Descrideo，并把异步返回的元数据送入审核队列。
- 新上传视频的元数据覆盖率从 18% 提升到 92%。
- 人工编目平均时间从约 2 个工作日缩短到 30 分钟以内。
- 编辑在审核开始时即可获得预填充的多语言标题、描述和标签。
无障碍工作流
02
培训资料库无障碍积压处理
挑战
内部学习门户需要为数百个历史培训录像生成描述草稿。
实施方式
视觉 + 音频模式生成首版摘要和结构化说明，供无障碍审核团队进一步处理。
- 审核人员将首稿编写时间缩短了约 60%。
- 团队通过同一个 webhook payload 填充 LMS 摘要和无障碍检查清单。
- 内容负责人为旧录制资料建立了统一的元数据基础。
目录自动化
03
大规模产品视频 SEO
挑战
一个电商目录需要为演示视频、开箱视频和对比视频提供一致的描述。
实施方式
Descrideo 生成面向 SEO 的文案，再由商品运营团队在发布前审核。
- 发布团队把批量文案创建时间从数小时缩短到几分钟。
- 搜索团队拿到了结构化标签和可直接用于 VideoObject 的字段。
- 商品团队通过批次级自定义指令保持品牌语气一致。