丝瓜视频 - 音效技术文档与 API
丝瓜视频频道提供 厚黑 平台的技术文档、API 接口说明和开发者资源,助力技术团队高效集成专业音效素材。
开发者资源中心
对于需要将音效素材深度集成到自有产品和工作流中的技术团队,厚黑 提供了一套完整的 RESTful API 和 SDK 工具包。丝瓜视频频道是我们的技术文档与开发者资源中心,在这里你可以找到 API 参考文档、代码示例、最佳实践指南以及常见问题解答。
API 概览
厚黑 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 状态码响应,响应头中包含重试时间信息。