RESTful API + Webhooks

视频描述
面向开发者的 API

将 AI 驱动的视频元数据生成集成到您的平台中。通过 API 提交视频 URL，通过 webhook 接收标题、描述和标签。全面分析视觉帧和音频内容。免费沙盒测试环境。

查看 API 文档查看定价

第一步

POST 提交视频 URL

发送带有视频 URL 的 POST 请求。支持直连或经过身份验证的访问。

第二步

异步处理

API 提取帧和音频并运行 AI 分析。通过任务 ID 跟踪状态或等待 webhook 回调。

第三步

接收 Webhook

通过带 HMAC 签名的 webhook 获取包含标题、描述和标签的 JSON 数据。

开发者选择 Descrideo API

专为规模化、安全性和开发体验而打造的企业级视频描述 API

免费沙盒测试

使用真实的 webhook 交付测试您的集成，无需处理视频。包含每日免费配额。

异步 Webhook 交付

带 HMAC 签名的非阻塞 API，支持指数退避的自动重试。

灵活的视频访问

支持直接 URL、身份验证访问或 Source Provider 模式。保护您的视频隐私。

灵活计费

预付代币余额或后付费模式。仅为成功处理付费，无隐藏费用。

音频转录

三种生成模式：纯视觉、视觉+音频组合、或纯音频。利用语音内容获取更丰富的描述。

企业级安全

SSRF 防护、静态数据加密、HMAC-SHA256 签名和审计日志。

简单的 REST API

只需几行代码即可开始

创建视频描述任务

# 创建任务 — visual、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",
    "transcription": {
      "segments": 10,
      "segment_sec": 30
    },
    "webhook": {
      "url": "https://your-app.com/webhooks/video"
    },
    "client_context": {
      "lang": "en",
      "output_fields": ["title", "description", "tags"]
    }
  }'

# 响应：202 Accepted
{
  "job_id": "01HXYZ123ABC",
  "status": "queued"
}

查看完整 API 文档