# media-url-import

> 将外部文件 URL 通过媒体上传接口转成站内可访问的文件 URL。适用于用户说“把外链文件转成内部链接/可访问链接/媒体 URL”、需要走 media.seedances.org 的 upload 接口、或需要生成 `https://media.seedances.org/media/download/{key}` 地址时。

- Author: wangsensnow@163.com
- Repository: myun-product/media-app-seedance
- Version: 20260208153148
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-08
- Source: https://github.com/myun-product/media-app-seedance
- Web: https://mule.run/skillshub/@@myun-product/media-app-seedance~media-url-import:20260208153148

---

---
name: media-url-import
description: 将外部文件 URL 通过媒体上传接口转成站内可访问的文件 URL。适用于用户说“把外链文件转成内部链接/可访问链接/媒体 URL”、需要走 media.seedances.org 的 upload 接口、或需要生成 `https://media.seedances.org/media/download/{key}` 地址时。
---

# Media Url Import

## 概览

将外部文件 URL 通过 `https://media.seedances.org/media/upload` 导入到内部存储，获得响应 `key`，再拼成内部可访问地址。

## 工作流（必走）

1. **收集输入**：外部 `url` 与文件名（用于拼接 `objectKey`）。
2. **构造请求体**：
   - `url`: 外部文件地址
   - `bucket`: 固定 `R2_BUCKET`
   - `objectKey`: 固定前缀 `0/public/` + 文件名（例如 `0/public/demo.png`）
3. **调用上传接口**：`POST https://media.seedances.org/media/upload`，带 `Authorization: bearer <token>` 与 JSON body。
4. **解析响应**：读取返回 JSON 的 `key`。
5. **生成内部 URL**：`https://media.seedances.org/media/download/{key}`（注意 `download/` 后有斜杠）。

## 快速命令（推荐）

使用脚本 `scripts/upload_video_from_url.sh`：

```bash
bash .codex/skills/media-url-import/scripts/upload_video_from_url.sh \\
  --url \"<外部文件URL>\" \\
  --filename \"demo.png\" \\
  --token \"<bearer token>\"
```

也可使用环境变量 `MEDIA_UPLOAD_TOKEN`（未传 `--token` 时自动读取）：

```bash
MEDIA_UPLOAD_TOKEN=\"<bearer token>\" \\
bash .codex/skills/media-url-import/scripts/upload_video_from_url.sh \\
  --url \"<外部文件URL>\" \\
  --filename \"demo.png\"
```

输出：
- `key`（例如 `0/public/demo.png`）
- `internal_url`（例如 `https://media.seedances.org/media/download/0/public/demo.png`）

## 注意事项

- `bucket` 固定为 `R2_BUCKET`，不要改。
- `objectKey` 必须以 `0/public/` 开头。
- `Authorization` 形如：`bearer <token>`。
- 不要在日志里泄露 token。
- `filename` 仅保留文件名，不要传路径分隔符。

## 参考资料

- 详细接口说明见：`references/media-upload-api.md`