<!-- Canonical URL: https://ask.atlascloud.ai/zh-TW/migrate-sora-app-input-files-output-urls -->

# 遷移 Sora 應用程式時，輸入檔案和輸出 URL 會發生什麼變化？

> 服務商檔案參照和生成影片連結不是可移植資產。應把原始輸入位元組保存在應用程式資產 ID 下，按目標格式重新上傳，分別對應來源與目標工作，並在服務商資源過期前把完成影片複製到持久儲存空間。

遷移 Sora 應用程式時，輸入參照通常需要按目標服務商要求重新上傳或轉換格式，生成影片的 URL 則應視為臨時下載位置。應在兩端加入資產層，統一管理持久檔案、校驗和、存取策略和服務商對應。

請求格式相容並不代表檔案 ID 或輸出連結可移植。這些資源通常只屬於簽發它們的服務商。

## 將資產與服務商參照分離

使用應用程式資產 ID 作為穩定主鍵：

```json
{
  "asset_id": "asset_01J...",
  "kind": "input_image",
  "sha256": "...",
  "storage_key": "inputs/asset_01J...png",
  "provider_refs": {
    "openai": "provider-specific-reference"
  }
}
```

來源檔案 ID、影片工作 ID 和簽名輸出 URL 都只是該記錄的屬性，不應成為產品對外的永久契約。

## 重新生成輸入參照

OpenAI 影片端點接收提示詞，也可接收可選的 `input_reference` 圖像。目標服務可能要求 multipart 上傳、預先上傳的檔案 ID、公開 URL 或 base64 資料。

對每個來源輸入，從持久儲存空間讀取原始檔案，驗證媒體類型與尺寸，再建立目標端參照。不要假設 OpenAI 檔案或媒體識別碼能提交給另一家服務商。

如果應用程式只保存了服務商參照而沒有原始檔案，應在遷移前確認能否下載。輸入若已過期或刪除，就需要使用者重新上傳，無法靠轉換識別碼恢復遺失的位元組。

## 明確對應工作物件

Sora 影片生成是非同步工作。工作包含 ID、狀態、進度、模型、時長、尺寸、時間戳記，也可能包含下載資產的過期時間。應並列保存目標工作和來源工作：

| 應用程式欄位 | 來源端對應 | 目標端對應 |
|---|---|---|
| 內部工作 ID | 你的資料庫 | 保持同一值 |
| 服務商工作 ID | OpenAI 影片 ID | 目標工作 ID |
| 狀態 | 來源狀態 | 統一後的目標狀態 |
| 輸入資產 | 來源參照 | 重新上傳後的目標參照 |
| 輸出資產 | 已下載位元組 | 已下載的目標位元組 |

分階段遷移期間不要覆寫來源端對應。保留兩套對應有助於復原與支援調查。

## 下載輸出內容，不只保存 URL

OpenAI API 為已完成影片提供內容端點，並在資源有有效期時報告 `expires_at`。回應中的 URL 可能失效、需要驗證，也可能不適合直接公開給用戶端。

工作完成後，工作程序應：

1. 從經過驗證的端點取得影片內容；
2. 以串流方式寫入應用程式控制的物件儲存空間；
3. 驗證媒體類型、大小和校驗和；
4. 記錄來源、模型、提示詞策略和生成參數；
5. 透過你自己的授權下載 URL 提供內容。

產品依賴的縮圖、預覽或其他可下載變體也應採用相同流程。

## 規劃保留與隱私策略

複製檔案會改變資料治理範圍。應分別定義使用者上傳、生成中間檔案、最終影片、縮圖和失敗工作的保留期。加密資產、限制服務帳號權限，並避免記錄簽名 URL 或原始提示詞。

收到刪除請求時，應刪除應用程式副本，並在支援時呼叫服務商刪除端點。保留不含敏感資訊的刪除記錄，使重試保持冪等。

## 切換前測試媒體行為

為每種允許的輸入格式、方向、解析度、時長和最大大小建立測試樣本。若參考圖像很重要，還要驗證透明通道與色彩設定檔。輸出測試應涵蓋連結過期、部分下載、內容類型不符、範圍請求、取消和工作程序當機後的重試。

還應比較媒體政策和審核結果，而不只是 API 機制。兩個服務商都接受請求，並不表示內容政策或生成結果相同。

## 總結

Sora 檔案參照和輸出 URL 是服務商資源，不是可移植資產。把原始輸入保存在自己的儲存空間中，為目標端建立新參照，及時下載完成的影片，並對外使用穩定的應用程式資產 ID，才能避免連結過期造成資料遺失。

## FAQ

### OpenAI input_reference 可以傳送給另一家影片服務商嗎？

通常不可以。應從自有儲存空間讀取原始檔案，再建立目標服務商要求的 multipart 上傳、檔案 ID、URL 或 base64 參照。

### Sora 輸出 URL 是永久的嗎？

應把它當作臨時或需驗證的交付位置。影片工作可能包含過期時間，因此要及時把內容下載到自有儲存空間。

### 如果只保存了服務商檔案 ID 怎麼辦？

在資源仍可用時嘗試取回原始位元組。若資源已經過期或刪除，使用者可能需要重新上傳來源檔案。

### 應用程式應公開哪個 ID？

公開自有的穩定資產 ID 與工作 ID，並把來源端和目標端的服務商 ID 保留為擷取、支援與復原對應。

### 切換後應覆寫來源端對應嗎？

不應覆寫。分階段遷移期間保留來源端與目標端對應，才能比較行為並安全復原。

### 影片資產需要測試什麼？

測試全部支援的格式、大小、時長、方向、下載變體、過期路徑、部分傳輸、取消和儲存重試。