准备 API Key,发起第一次音效搜索并读取返回结果。
登录爱给账号,进入 API Key 管理,创建并复制密钥。请把密钥保存在服务端环境变量或安全配置中。
POST https://www.aigei.com/open/api/v1/audio/search
下面示例适用于 Bash / zsh。先在本机安全配置 AIGEI_API_KEY 环境变量,再执行请求。
curl --request POST \
'https://www.aigei.com/open/api/v1/audio/search' \
--header "Authorization: Bearer $AIGEI_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"keyword":"雨声","cat":"sound","pageNumber":1}'
Windows PowerShell 可使用以下方式:
$headers = @{ Authorization = "Bearer $env:AIGEI_API_KEY" }
$body = @{ keyword = '雨声'; cat = 'sound'; pageNumber = 1 } | ConvertTo-Json
Invoke-RestMethod -Method Post `
-Uri 'https://www.aigei.com/open/api/v1/audio/search' `
-Headers $headers -ContentType 'application/json; charset=utf-8' `
-Body ([System.Text.Encoding]::UTF8.GetBytes($body))
本次仅搜索素材,不下载文件。
| 字段 | 查看内容 |
|---|---|
| code | 10001 表示成功;其他状态按错误说明处理 |
| data.itemList | 素材列表,读取 itemId、itemTitle 和 fileList |
| fileList[].fileId | 所选文件编号,用于后续文件下载 |
| fileList[].downloadFund | 该文件当前的下载应付费用,尚未扣除 |
| quota.remaining | 剩余查询调用额度 |
| requestId | 本次请求编号,向客服反馈问题时提供 |
搜索成功但列表为空时,可以调整关键词或筛选条件。请使用实际返回的编号,不复制文档中的样例编号继续调用。
搜索结果已包含素材信息、文件规格与报价,可直接从 fileList 选择文件。已知资源编号、需要重新查询该素材当前信息时,可调用详情接口;详情与搜索结果中单个素材的返回结构相同。