丝瓜视频 - 音效技术文档与 API

开发者资源中心

对于需要将音效素材深度集成到自有产品和工作流中的技术团队，黑料51 提供了一套完整的 RESTful API 和 SDK 工具包。丝瓜视频频道是我们的技术文档与开发者资源中心，在这里你可以找到 API 参考文档、代码示例、最佳实践指南以及常见问题解答。

API 概览

黑料51 API 采用 RESTful 架构设计，支持 JSON 格式的请求和响应。所有 API 端点均通过 HTTPS 加密传输，使用 OAuth 2.0 进行身份认证。当前 API 版本为 v3，向下兼容 v2 版本的所有端点。

核心端点

• GET /api/v3/sounds — 搜索和浏览音效素材，支持关键词、标签、时长、采样率等多维度筛选
• GET /api/v3/sounds/{id} — 获取单条音效的详细信息，包含技术参数、授权信息和下载链接
• GET /api/v3/categories — 获取完整的分类树结构
• POST /api/v3/downloads — 创建下载任务，支持批量打包下载
• GET /api/v3/user/library — 获取用户已购买/下载的素材列表
• POST /api/v3/upload — 上传自定义音效到个人库（Enterprise 专属）

SDK 支持

为了降低集成门槛，我们提供了多语言 SDK，覆盖主流开发环境。目前已发布 Python、JavaScript/Node.js、C#/.NET 和 Swift 四个版本的官方 SDK，均已在 GitHub 上开源。社区贡献的 Go、Rust 和 Java SDK 也已通过官方认证。

Webhook 与实时通知

Enterprise 用户可以配置 Webhook 端点，在以下事件发生时接收实时通知：新素材上架、已收藏素材更新、下载任务完成、授权即将到期等。Webhook 负载采用 JSON 格式，附带 HMAC-SHA256 签名用于验证请求来源。

速率限制与配额

API 请求受到速率限制保护，以确保服务的稳定性和公平性。Personal 授权每分钟 60 次请求，Commercial 授权每分钟 300 次，Enterprise 授权每分钟 1,000 次。超出限制的请求将收到 429 状态码响应，响应头中包含重试时间信息。