视频提取文案音频分离接口api开发文档
五、返回数据说明 （一）返回参数。AI视频分析接口开发文档 一、接口概述 本接口用于实现 AI 视频分析功能，支持传入视频地址信息（含短视频分享链接等），获取视频相关的提取文字信息、视频音频 URL 下载地址、视频封面地址等数据，助力开发者快速获取视频核心信息及相关资源。音频地址兼容性：返回的音频地址（如示例中的 https://#/#.mp3）可能存在格式支持问题，若需使用该音频资源，需提前确认
AI视频分析接口开发文档 一、接口概述 本接口用于实现 AI 视频分析功能，支持传入视频地址信息（含短视频分享链接等），获取视频相关的提取文字信息、视频音频 URL 下载地址、视频封面地址等数据，助力开发者快速获取视频核心信息及相关资源。 二、内容获取情况说明 在对接接口所需的视频资源时，遇到两处资源访问问题：
-
xx视频链接（https://#/XPPhzFTNrcU/）：系统提示 “该视频为非公开视频，无法访问”，无法获取该视频的具体内容用于接口测试或分析。
-
MP3 格式链接（https://#/#.mp3）：系统提示 “网页解析失败，可能是不支持的网页类型，请检查网页或稍后重试”，无法解析该链接对应的音频资源。 建议后续使用接口时，确保传入的视频地址、音频地址对应的资源为公开可访问状态，且格式符合接口支持要求，避免因资源访问问题影响接口正常调用。
三、核心信息 （一）接口地址 https://#/api/aibasic/videoanalysis （二）返回格式 application/json （三）请求方式 支持 HTTP GET / POST 两种请求方式 四、请求配置 （一）请求头（HEADER）
|
名称 |
值 |
|
Content-Type |
application/x-www-form-urlencoded;charset=utf-8 |
（二）请求参数
|
名称 |
必填 |
类型 |
示例值 |
说明 |
|
key |
是 |
string |
35kj5jnlj53453kl5j43nj5 |
接口密钥，需在控制台 -> 密钥管理页面查看获取，作为接口访问的身份凭证 |
|
content |
是 |
string |
降温了保暖打底衫真的得提前备起来～这件的版型显瘦又漂亮，主要是还保暖 #秋冬新款 #内搭外穿都好看 #保暖又好看 https://v.douyin.com/XPPhzFTNrcU/ 复制此链接，打开【x】，直接观看视频！ |
视频地址信息，可包含短视频描述文字、分享链接等内容，需确保链接对应的视频可公开访问 |
（三）请求示例 GET 请求示例 https://#/api/aibasic/videoanalysis?key=35kj5jnlj53453kl5j43nj5&content=降温了保暖打底衫真的得提前备起来~ 这件的版型显瘦又漂亮，主要是还保暖 #秋冬新款 #内搭外穿都好看#保暖又好看 https://v.douyin.com/XPPhzFTNrcU/ 复制此链接，打开【x】，直接观看视频！ POST 请求示例 请求体按 application/x-www-form-urlencoded 格式拼接参数： key=35kj5jnlj53453kl5j43nj5&content=降温了保暖打底衫真的得提前备起来~ 这件的版型显瘦又漂亮，主要是还保暖 #秋冬新款 #内搭外穿都好看#保暖又好看 https://#/XPPhzFTNrcU/ 复制此链接，打开【xx】，直接观看视频！ 五、返回数据说明 （一）返回参数
|
名称 |
类型 |
说明 |
|
code |
int |
状态码（200 表示请求成功，其他为异常） |
|
msg |
string |
状态信息（成功时返回 "success"） |
|
data |
object |
请求结果数据集，包含视频核心分析数据 |
|
text |
string |
从视频相关信息中提取的文字信息 |
|
prompt |
array |
视频相关资源地址集合，含下载链接、视频标题、视频封面、音频地址等 |
|
debug |
string/array |
调试数据（异常时返回，用于定位问题，如资源访问失败原因、参数错误详情等） |
|
exec_time |
float |
接口执行耗时（单位：秒） |
|
user_ip |
string |
客户端 IP 地址 |
（二）返回示例（成功） { "code": 200, "msg": "success", "data": { "text": "为什么刮风降温的天气，单穿一件毛衣很暖和？", "summary": "", "prompt": [ { "title": "下载链接", "prompt": "https://#" }, { "title": "视频标题", "prompt": "降温了" }, { "title": "视频封面", "prompt": "https://#" }, { "title": "音频地址", "prompt": "https://#/#.mp3" } ] }, "exec_time": 12.487509, "user_ip": "117.188.13.239" } （三）状态码说明
-
200：请求成功，已完成视频分析，可从 data 字段获取提取的文字信息及相关资源地址。
-
4xx：客户端错误，常见原因包括：
-
400：参数错误（如 key 缺失、content 为空或格式无效），可通过 msg 字段查看具体错误提示。
-
401：权限验证失败（如 key 无效、过期），需重新在控制台获取有效密钥。
-
5xx：服务端错误，此时可通过 debug 字段查看调试信息，或稍后重试接口。
六、开发注意事项
-
资源访问有效性：传入 content 中的视频链接需为公开可访问状态，避免因视频非公开、链接失效等问题导致接口无法正常分析视频数据（如前文提及的xx非公开视频无法访问的情况）。
-
参数格式规范：content 字段若包含特殊字符（如空格、#、& 等），需进行 URL 编码（GET 请求时）或按 application/x-www-form-urlencoded 格式处理（POST 请求时），防止参数解析错误。
-
密钥安全保护：key 为接口访问的重要凭证，请勿在前端代码、公开文档中泄露，若怀疑密钥泄露，需及时在控制台重置密钥，避免接口被非法调用。
-
音频地址兼容性：返回的音频地址（如示例中的 https://#/#.mp3）可能存在格式支持问题，若需使用该音频资源，需提前确认接口支持的音频格式，避免出现解析失败情况（如前文提及的 MP3 链接解析失败问题）。
-
回调与异步处理：若接口处理视频分析任务耗时较长，建议结合业务场景设计异步处理逻辑，可通过定时查询或配置回调机制获取最终分析结果，避免同步请求超时。
-
错误排查方法：当接口返回非 200 状态码时，优先查看 msg 字段的错误描述，再结合 debug 字段的调试数据定位问题，常见排查方向包括参数完整性、密钥有效性、视频链接可访问性等。
来源：酷虎云api开放平台
火山引擎开发者社区是火山引擎打造的AI技术生态平台，聚焦Agent与大模型开发，提供豆包系列模型（图像/视频/视觉）、智能分析与会话工具，并配套评测集、动手实验室及行业案例库。社区通过技术沙龙、挑战赛等活动促进开发者成长，新用户可领50万Tokens权益，助力构建智能应用。
更多推荐
3
0- 0
已为社区贡献10条内容
所有评论(0)