Tạo video

Tạo tác vụ bất đồng bộ từ prompt văn bản và hình ảnh tham chiếu tùy chọn, rồi nhận Video ID để truy vấn trạng thái và tải kết quả.

POST/v1/videos

Tạo tác vụ tạo video bất đồng bộ từ prompt văn bản và hình ảnh tham chiếu tùy chọn. API nhận yêu cầu Multipart tương thích OpenAI Videos và trả về Video ID để truy vấn trạng thái tác vụ.

Thời lượng, kích thước, hình ảnh tham chiếu và tham số mở rộng được hỗ trợ có thể khác nhau giữa các mô hình video. Hãy chọn ID mô hình hỗ trợ tạo video và khả dụng với API Key hiện tại.

Xác thực

bearerAuth

Xác thựcBearer <token>

Sử dụng Bearer your-api-key trong Header Authorization.

Vị trí truyền: header

Nội dung yêu cầu

multipart/form-data

Gửi prompt, mô hình và hình ảnh tham chiếu tùy chọn bằng Multipart. Phía máy khách nên để thư viện gửi yêu cầu tự tạo boundary của Content-Type.

Định nghĩa kiểu TypeScript

Sử dụng kiểu request body trong TypeScript.

prompt*string

Mô tả nội dung video muốn tạo. Nên nêu rõ chủ thể, hành động, bối cảnh, góc quay, phong cách và yêu cầu chất lượng.

Độ dài1 <= length

model?string

ID mô hình video cần sử dụng. Hãy chọn mô hình hỗ trợ tạo video và khả dụng với API Key hiện tại; dạng đầu vào và tham số mở rộng được hỗ trợ có thể khác nhau giữa các mô hình.

Độ dài1 <= length

seconds?string

Thời lượng video, tính bằng giây, mặc định là 4; thời lượng khả dụng tùy thuộc vào mô hình đã chọn.

Giá trị mặc định"4"

size?string

Kích thước video đầu ra, thường dùng định dạng chiều rộngxchiều cao, mặc định là 720x1280; kích thước khả dụng tùy thuộc vào mô hình đã chọn.

Giá trị mặc định"720x1280"

input_reference?file

Hình ảnh tham chiếu được tải lên để tạo video từ hình ảnh. Một số mô hình tương thích không nhận tệp tải lên trực tiếp; cần truyền URL hình ảnh qua metadata.img_url.

Định dạngbinary

metadata?string

Tham số mở rộng riêng của nhà cung cấp hoặc mô hình, phải gửi dưới dạng chuỗi JSON. Không xem các trường này là tham số chung được mọi mô hình video hỗ trợ.

Các khóa mở rộng của dòng Wan gồm img_url, first_frame_url, last_frame_url, watermark, prompt_extend, audio, seed và resolution. URL hình ảnh dùng để tạo video từ hình ảnh; URL khung hình đầu/cuối dùng để tạo video từ keyframe; audio chỉ áp dụng cho mô hình hỗ trợ tạo âm thanh.

Các tùy chọn độ phân giải gồm 480P (832x480, 480x832, 624x624), 720P (1280x720, 720x1280, 960x960, 1088x832, 832x1088) và 1080P (1920x1080, 1080x1920, 1440x1440, 1632x1248, 1248x1632). Phạm vi hỗ trợ thực tế tùy thuộc vào mô hình đã chọn.

Nội dung phản hồi

`application/json`

curl -X POST "https://example.com/v1/videos" \  -F prompt="Một phi hành gia mặc bộ đồ du hành vũ trụ đang đi trên Mặt Trăng, chất lượng cao, phong cách điện ảnh" \  -F model="MODEL_ID" \  -F seconds="4" \  -F size="720x1280"

{
  "id": "video_123",
  "object": "video",
  "model": "MODEL_ID",
  "created_at": 1640995200,
  "status": "processing",
  "progress": 0
}

Xác thực

Nội dung yêu cầu

Nội dung phản hồi

201application/json

400application/json

401application/json

403application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`