丝瓜视频 - 音效技术文档与 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 状态码响应，响应头中包含重试时间信息。
