配置视频参考图存储

创建 R2 存储桶

1. 在英文 Cloudflare 控制台中，打开 Storage & databases → R2 Object Storage，即可看到存储桶列表。首次使用时按提示开通 R2 并确认计费；存储费用与 Orqra、模型费用分开。

   

2. 点击 Create bucket，在 Bucket name 中填写 orqra-video-inputs，Location 保持 Automatic，再在 Default Storage Class 中选择 Standard。

   

3. 点击 Create bucket，确认存储桶列表中出现 orqra-video-inputs。保持私有，不需要启用 r2.dev 公共访问或添加自定义域名。

• 打开 R2 控制台
• Cloudflare 开通说明
• 创建 Bucket 官方步骤

填写基础配置

1. 在 R2 Object Storage 总览页的 Account Details 卡片中，找到 S3 API，点击该行右侧的复制图标。

   Endpoint 示例：https://example-account-id.r2.cloudflarestorage.com。这里使用的是示例账号，地址不含桶名；请使用从自己账号复制的原始地址。

   

2. 打开 Orqra 桌面端的“设置 → 数据与存储 → HTTPS 素材存储”，将复制的地址原样粘贴到 Endpoint，并在 Bucket 中单独填写创建的桶名，其余按下表保持 R2 默认设置。Access Key ID 和 Secret Access Key 暂时留空；保持此设置页打开，拿到密钥后一起保存。

   基础配置填写对照

   Orqra 中的字段	填写什么 / 去哪里找
   Endpoint	从 Account Details 的 S3 API 行复制地址，原样粘贴到 Endpoint；不要使用控制台网址或 r2.dev 公共地址。
   Region	auto
   Bucket	单独填写创建的桶名，例如 orqra-video-inputs；不要把桶名拼接到 Endpoint。
   临时对象前缀	orqra-transient/，必须与稍后设置的自动删除规则的 Prefix 一致。
   Session Token	首次使用本教程创建的普通 R2 凭证时留空。
   签名 URL 有效期（秒）	21600（6 小时），这是临时下载链接的有效期，不是文件删除时间。
   使用 Path-Style URL	保持开启。

• S3 接入官方说明

创建访问密钥

1. 在 R2 Object Storage 页的 Account Details 中点击 Manage API Tokens。

   

2. 进入管理页后，在 User API Tokens 区域点击 Create User API token。

   

3. 在 Create User API Token 表单中，Token name 填写 orqra-video-inputs；在 Permissions 中选择 Object Read & Write。

   在 Specify bucket(s) 中选择 Apply to specific buckets only，再选中前面创建的同一个 Bucket：orqra-video-inputs。

   TTL 默认为 Forever；需要其他凭证有效期时，在此控件中选择。在 Client IP Address Filtering 中，通常可将 Include 和 Exclude 两个输入框都留空，只有需要限制 IP 时才填写。

   

4. 点击表单底部的 Create User API Token。结果页中的 Secret Access Key 只显示一次，请保持结果页打开，立即按下一节将 Access Key ID 和 Secret Access Key 补填到 Orqra 并保存，确认保存成功后再关闭结果页。这两项是 Orqra 需要的 S3 凭证，不是 API Token 值，也不是 OpenRouter API Key。

• 获取 R2 密钥

补填密钥并保存

1. 返回刚才保持打开的 Orqra 设置页，保留已填写的基础信息，只补填下表中的两项密钥。

   密钥填写对照

   Orqra 中的字段	填写什么 / 去哪里找
   Access Key ID	从刚才的 Cloudflare 结果页复制 Access Key ID，粘贴到这里。
   Secret Access Key	从同一个 Cloudflare 结果页复制 Secret Access Key，粘贴到这里；它只显示一次，只在 Orqra 桌面端填写。

   

2. 点击“保存配置”，确认出现“HTTPS 素材存储配置已保存。”后，再关闭 Cloudflare 结果页。仅粘贴密钥不会保存配置；保存不会上传文件。

设置自动删除

1. 打开 orqra-video-inputs → Settings → Object Lifecycle Rules，点击 Add。

2. 按下表填写四项设置，打开 Object lifecycle rule is enabled 开关，再点击 Save changes。

   自动删除规则填写对照

   Cloudflare 中的字段	填写或选择什么
   Rule name	delete-orqra-transient，用于识别规则，不是对象前缀。
   Apply to objects with the following prefix (optional):	填写 orqra-transient/，不要留空；必须与 Orqra 的临时对象前缀一致。
   Delete uploaded objects after:	勾选此项，填写 1，单位选择 Days。
   Object lifecycle rule is enabled	打开此开关，再点击 Save changes。

   

3. 在保存后的列表中核对四列：Rule Name 为 delete-orqra-transient，Prefix 为 orqra-transient/，Actions 为 Delete objects after 1 day(s)，Status 为 Enabled。Cloudflare 在后台执行删除，实际删除可能延后；默认的“7 天后清理未完成分段上传”规则不能替代这条规则。

   

• 设置自动删除规则

测试并返回视频节点

1. 保存配置并设置好自动删除规则后，返回 Orqra，点击“测试 HTTPS 输入”。Orqra 会上传、下载、校验并删除极小探针，可能产生少量存储请求费用；不会调用 OpenRouter 或创建视频任务。

2. 等待出现“HTTPS 上传与下载测试通过。”。如果提示错误，按下方说明检查后重新测试。存储测试成功不能保证模型服务商后续的每次抓取都成功。

   

3. 自行回到画布，在视频节点中选择图片，准备好后主动点击“运行”。保存或测试存储不会开始生成。

存储测试失败怎么办