火山方舟
火山方舟
资源
请输入
- 文档首页
火山方舟实践教程通过 TOS 内网预签名 URL 传入文件
复制全文
下载 pdf通过 TOS 内网预签名 URL 传入文件
文档反馈
问问助手您可以将文件存储在华北2（cn-beijing）Region 的私有对象存储桶（TOS）中，通过内网（火山引擎云内部网络）域名生成 GET 预签名 URL，在不公开源文件的前提下，将图片、视频等文件传入火山方舟。生成的预签名 URL 示例如下：
该方式具有以下优势：
- 链接无法通过外网（公开可访问网络）直接访问源文件，数据安全性更高。
- 不消耗公网流量，可降低网络成本，并提升文件传输效率。
注意
TOS 存储桶、TOS 内网域名与火山方舟服务需保持在华北2（cn-beijing）Region。
步骤一：生成 TOS 内网预签名 URL
针对已存储在 TOS 中的对象，生成一个仅用于读取的 GET 预签名 URL。
配置以下环境变量：
以视频文件为例，示例代码如下：
说明
示例输出：
该 URL 仅可被华北2（cn-beijing）Region 内的火山引擎基础设施访问（如火山方舟），无法通过外网直接访问。
步骤二：使用预签名 URL 调用火山方舟
将步骤一生成的预签名 URL 作为 video_url 传入模型，对视频内容进行理解。
示例代码如下：
- 按需替换 Model ID，查询 Model ID 参见 模型列表。
常见问题
方舟无法读取输入文件
请优先检查以下内容：
- TOS Bucket 与火山方舟服务是否位于华北2（cn-beijing）Region。
- 是否使用了正确的内网域名，例如华北2（cn-beijing）Region 的 tos-cn-beijing.ivolces.com。
- 预签名 URL 是否已过期。
- 对象是否存在，且对象 Key 与签名时使用的值完全一致。
- URL 是否在传递过程中被截断、重复编码或丢失查询参数。
- 所选模型是否支持当前输入类型。
最近更新时间：2026.10.09 14:36:34
这个页面对您有帮助吗？
有用
有用
无用
无用