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

# Điều gì xảy ra với tệp đầu vào và URL đầu ra khi di chuyển ứng dụng Sora?

> Tham chiếu tệp và liên kết video của nhà cung cấp không phải tài sản có thể chuyển. Giữ byte gốc dưới ID tài sản riêng, tải lại theo định dạng đích, ánh xạ riêng tác vụ nguồn và đích, rồi chép video hoàn tất trước khi tài nguyên hết hạn.

Khi di chuyển ứng dụng Sora, tham chiếu đầu vào thường phải được tải lên lại hoặc định dạng lại cho nhà cung cấp đích, còn URL video đã tạo nên được coi là vị trí tải xuống tạm thời. Hãy đặt cả hai phía sau một lớp tài sản quản lý tệp bền vững, checksum, chính sách truy cập và ánh xạ nhà cung cấp.

Hình dạng yêu cầu tương thích API không làm cho ID tệp hoặc liên kết đầu ra có thể chuyển được. Các tài nguyên đó thường thuộc về nhà cung cấp đã cấp chúng.

## Tách tài sản khỏi tham chiếu nhà cung cấp

Dùng ID tài sản của ứng dụng làm khóa ổn định:

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

ID tệp nguồn, ID tác vụ video và URL đầu ra có chữ ký là thuộc tính của bản ghi này, không phải định danh được đưa ra như hợp đồng vĩnh viễn của sản phẩm.

## Tái tạo tham chiếu đầu vào

Endpoint video của OpenAI nhận prompt và có thể nhận ảnh `input_reference` tùy chọn. Dịch vụ đích có thể yêu cầu tải lên multipart, ID tệp đã tải trước, URL công khai hoặc dữ liệu base64.

Với mỗi đầu vào nguồn, hãy đọc bản gốc bền vững từ kho của bạn, xác thực loại media và kích thước, rồi tạo tham chiếu dành riêng cho đích. Không giả định có thể gửi định danh tệp hoặc media của OpenAI sang nhà cung cấp khác.

Nếu ứng dụng chỉ lưu tham chiếu nhà cung cấp mà không lưu bản gốc, hãy kiểm tra xem tài nguyên còn tải xuống được trước khi di chuyển hay không. Đầu vào đã hết hạn hoặc bị xóa đòi hỏi người dùng tải lại; không có phép chuyển đổi định danh an toàn nào có thể tái tạo các byte đã mất.

## Ánh xạ rõ ràng đối tượng tác vụ

Tạo video Sora là bất đồng bộ. Tác vụ có ID, trạng thái, tiến độ, mô hình, thời lượng, kích thước, dấu thời gian và có thể có thời điểm hết hạn cho tài sản tải xuống. Lưu tác vụ đích cạnh tác vụ nguồn:

| Trường ứng dụng | Ánh xạ nguồn | Ánh xạ đích |
|---|---|---|
| ID tác vụ nội bộ | Cơ sở dữ liệu của bạn | Cùng một giá trị |
| ID tác vụ nhà cung cấp | ID video OpenAI | ID tác vụ đích |
| Trạng thái | Trạng thái nguồn | Trạng thái đích đã chuẩn hóa |
| Tài sản đầu vào | Tham chiếu nguồn | Tham chiếu đích được tải lại |
| Tài sản đầu ra | Byte đã tải xuống | Byte đích đã tải xuống |

Không bao giờ ghi đè ánh xạ nguồn trong quá trình di chuyển theo giai đoạn. Giữ cả hai giúp có thể rollback và điều tra hỗ trợ.

## Tải nội dung đầu ra, không chỉ lưu URL

API OpenAI cung cấp endpoint nội dung cho tác vụ video hoàn tất và báo `expires_at` khi tài sản có thời điểm hết hạn. URL sao chép từ phản hồi có thể ngừng hoạt động, yêu cầu xác thực hoặc không phù hợp để đưa trực tiếp cho khách hàng.

Khi hoàn tất, worker của bạn nên:

1. lấy nội dung video từ endpoint đã xác thực;
2. truyền dữ liệu vào kho đối tượng do ứng dụng kiểm soát;
3. xác minh loại media, kích thước tệp và checksum;
4. ghi nguồn gốc, mô hình, chính sách prompt và tham số tạo;
5. phục vụ qua URL phân phối được ủy quyền của riêng bạn.

Áp dụng cùng quy trình cho thumbnail, preview hoặc biến thể tải xuống khác mà sản phẩm phụ thuộc.

## Lập kế hoạch lưu giữ và quyền riêng tư

Sao chép tệp làm thay đổi quản trị dữ liệu. Xác định lưu giữ riêng cho tệp người dùng tải lên, dữ liệu trung gian tạo, video cuối, thumbnail và tác vụ thất bại. Mã hóa tài sản lưu trữ, hạn chế vai trò dịch vụ và tránh ghi URL có chữ ký hoặc prompt thô vào log.

Khi có yêu cầu xóa, hãy xóa bản sao của ứng dụng và gọi endpoint xóa của nhà cung cấp khi có. Giữ một dấu mốc xóa với định danh không nhạy cảm để các lần thử lại vẫn idempotent.

## Kiểm thử hành vi media trước khi chuyển

Tạo fixture cho mọi định dạng đầu vào, hướng, độ phân giải, thời lượng và kích thước tối đa được chấp nhận. Xác minh kênh alpha và hồ sơ màu nếu tham chiếu ảnh quan trọng. Với đầu ra, kiểm thử liên kết hết hạn, tải một phần, sai loại nội dung, range request, hủy và thử lại sau khi worker gặp sự cố.

So sánh chính sách media được tạo và kết quả kiểm duyệt bên cạnh cơ chế API. Một yêu cầu được cả hai nhà cung cấp chấp nhận về cú pháp vẫn có thể khác về nội dung được phép hoặc đặc tính kết quả.

## Kết luận

Tham chiếu tệp và URL đầu ra của Sora là tài nguyên của nhà cung cấp, không phải tài sản có thể chuyển. Hãy giữ byte đầu vào gốc trong kho của bạn, tạo tham chiếu đích mới, tải video hoàn tất kịp thời và cung cấp ID tài sản ổn định của ứng dụng. Cách này giúp di chuyển có thể đảo ngược và ngăn liên kết hết hạn trở thành mất dữ liệu.

## FAQ

### Có thể gửi input_reference của OpenAI sang nhà cung cấp video khác không?

Thường là không. Đọc tệp gốc từ kho của bạn và tạo upload multipart, ID tệp, URL hoặc tham chiếu base64 theo yêu cầu của đích.

### URL đầu ra Sora có vĩnh viễn không?

Hãy xem chúng là nơi giao tạm thời hoặc có xác thực. Tác vụ có thể báo thời gian hết hạn, vì vậy cần tải nội dung sớm về kho riêng.

### Nếu chỉ lưu ID tệp của nhà cung cấp thì sao?

Cố lấy byte gốc khi tài nguyên còn tồn tại. Nếu đã hết hạn hoặc bị xóa, người dùng có thể phải tải lại tệp gốc.

### Ứng dụng nên hiển thị ID nào?

Hiển thị ID tài sản và tác vụ ổn định của riêng bạn. Giữ ID nhà cung cấp nguồn và đích làm ánh xạ để truy xuất, hỗ trợ và rollback.

### Có nên ghi đè ánh xạ nguồn sau chuyển đổi không?

Không. Giữ cả hai ánh xạ trong quá trình di chuyển theo giai đoạn để so sánh hành vi và rollback an toàn.

### Cần kiểm thử gì cho tài sản video?

Kiểm thử định dạng, kích thước, thời lượng, hướng và biến thể được hỗ trợ, cùng hết hạn, tải một phần, hủy và thử lại lưu trữ.