agnetxiaohei/DOWNLOAD_PATH_EXPLANATION.md

下载路径说明

下载流程

1. 搜索视频

• 使用 search_youtube 搜索 YouTube 视频
• 返回视频列表（包含 video_id、title、url 等）

2. 下载视频

• 使用 download_and_upload 或 search_and_download 下载视频
• 临时存储：文件先下载到系统临时目录（如 /tmp/xxxxx.mp4）
• 上传到云存储：然后上传到 Azure Blob Storage
• 自动清理：临时文件在上传后自动删除

3. 返回结果

• 返回 Azure Blob Storage URL（可用于访问和分析）

文件路径说明

临时文件路径

• 位置：系统临时目录（Linux: /tmp/, Windows: %TEMP%）
• 格式：/tmp/tmp{随机字符串}.mp4
• 生命周期：下载后立即上传，上传完成后自动删除
• 注意：临时文件不会保留，仅用于中转

Azure Blob Storage 路径

• 容器名称：taijiagnetsp（硬编码）
• 文件命名：{时间戳}_{随机ID}.{扩展名}
  • 示例：20250123143045_a1b2c3d4.mp4
• 完整路径：taijiagnetsp/20250123143045_a1b2c3d4.mp4
• 访问 URL：
  • 公共模式：https://dazhi1hao.blob.core.windows.net/taijiagnetsp/20250123143045_a1b2c3d4.mp4
  • 私有模式：https://dazhi1hao.blob.core.windows.net/taijiagnetsp/20250123143045_a1b2c3d4.mp4?{SAS_TOKEN}

返回结果示例

成功响应

{
  "success": true,
  "title": "视频标题",
  "author": "作者",
  "format": "mp4",
  "quality": "720p",
  "size_bytes": 12345678,
  "blob_name": "20250123143045_a1b2c3d4.mp4",
  "blob_container": "taijiagnetsp",
  "url": "https://dazhi1hao.blob.core.windows.net/taijiagnetsp/20250123143045_a1b2c3d4.mp4",
  "download_info": {
    "temp_file_path": "/tmp/tmpXXXXXX.mp4",
    "blob_storage_path": "taijiagnetsp/20250123143045_a1b2c3d4.mp4",
    "note": "临时文件已自动删除，文件已上传到 Azure Blob Storage"
  }
}

失败响应

{
  "success": false,
  "error": "Download failed: HTTP 403",
  "error_details": "详细错误信息...",
  "download_url": "https://googlevideo.com/...",
  "attempt": 2,
  "max_retries": 2,
  "suggestion": "可能是 URL 已过期、需要特殊认证或网络问题。尝试重新搜索并下载。"
}

常见问题

Q: 为什么下载失败（403错误）？

A: 可能的原因：

1. URL 已过期：Google Video 链接有时效性（通常几分钟）
2. 需要特殊认证：某些视频需要登录或特殊权限
3. 网络问题：IP 被限制或网络不稳定
4. RapidAPI 限制：API 调用频率过高

解决方案：

• 重新搜索并立即下载（减少延迟）
• 检查网络连接
• 等待一段时间后重试

Q: 下载的文件存储在哪里？

A:

• 临时存储：系统临时目录（自动删除）
• 永久存储：Azure Blob Storage 容器 taijiagnetsp
• 访问方式：使用返回的 url 字段（Blob URL）

Q: 如何访问下载的文件？

A: 使用返回结果中的 url 字段：

# 如果容器是公共的
curl "https://dazhi1hao.blob.core.windows.net/taijiagnetsp/20250123143045_a1b2c3d4.mp4"

# 如果容器是私有的，URL 已包含 SAS token
curl "https://dazhi1hao.blob.core.windows.net/taijiagnetsp/20250123143045_a1b2c3d4.mp4?{SAS_TOKEN}"

Q: 临时文件会保留吗？

A: 不会。临时文件在上传完成后立即自动删除，不会占用磁盘空间。

使用建议

1. 下载后立即使用：下载完成后，立即使用返回的 Blob URL 进行分析
2. 检查容器权限：如果用于 Azure Content Understanding 分析，确保容器设置为公共读取
3. 处理错误：如果下载失败，查看 error_details 和 suggestion 字段获取解决建议