Tạo video Sora 2

Tạo video với Sora 2 thông qua APIMaster. Các mô hình được hỗ trợ: sora-2, sora-2-pro. Tên sora ánh xạ tới sora-2.

Base URL: https://apimaster.ai/v1 là https://apimaster.ai/v1. Sử dụng https://apimaster.ai/v1/videos/... — không thêm /v1 nữa.

Giá (giảm 20% so với chính hãng, tính theo giây)

Hóa đơn được tính = thời lượng (giây) × tỷ lệ mỗi giây.

Mô hình	Độ phân giải	Chính hãng	APIMaster
sora-2	720p	$0,10 / giây	$0,08 / giây
sora-2-pro	720p	$0,30 / giây	$0,24 / giây
sora-2-pro	1024p	$0,50 / giây	$0,40 / giây
sora-2-pro	1080p	$0,70 / giây	$0,56 / giây

Ví dụ: 4 giây của sora-2 ở 720p ≈ $0,32 ($0,08 × 4).

Gửi tác vụ

Hai điểm truy cập — sử dụng một trong hai.

Tùy chọn A (khuyến nghị): JSON gốc

POST https://apimaster.ai/v1/videos/generations

Trường	Kiểu	Bắt buộc	Mô tả
model	chuỗi	có	sora-2 / sora-2-pro (hoặc sora)
prompt	chuỗi	có	Mô tả video
duration	số nguyên	không	Thường: 4 / 8 / 12 / 16 / 20, mặc định 4
resolution	chuỗi	không	sora-2: 720p; sora-2-pro: thêm 1024p / 1080p, mặc định 720p
aspect_ratio	chuỗi	không	16:9 / landscape hoặc 9:16 / portrait, mặc định 16:9
image_urls	mảng chuỗi	không	Chuyển hình ảnh thành video; khuyến nghị 1 URL công khai

curl -s "https://apimaster.ai/v1/videos/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "Một thác nước tạo thành cầu vồng, điện ảnh",
    "duration": 4,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

Phản hồi gửi

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxx"
    }
  ]
}

Đặt aspect_ratio một cách tường minh cho chuyển hình ảnh thành video (portrait → 9:16). Mặc định là 16:9.

Tùy chọn B: Tương thích OpenAI Video

POST https://apimaster.ai/v1/videos (JSON hoặc multipart)

Trường	Kiểu	Bắt buộc	Mô tả
model	chuỗi	có	sora-2 / sora-2-pro (hoặc sora)
prompt	chuỗi	có	Mô tả video
seconds	chuỗi	không	Thời lượng, ví dụ "4"; duration kiểu số nguyên cũng hoạt động, mặc định 4
size	chuỗi	không	Kích thước pixel — độ phân giải + hướng (bảng dưới), mặc định 720x1280
images	mảng chuỗi	không	Chuyển hình ảnh thành video; tối đa 1 URL. input_reference (đơn) cũng hoạt động

Giá trị size

Mô hình	Landscape (16:9)	Portrait (9:16)
sora-2	1280x720 (720p)	720x1280 (720p)
sora-2-pro	1280x720 (720p) / 1792x1024 (1024p)	720x1280 (720p) / 1024x1792 (1024p)

size không hợp lệ (ví dụ 1920x1080) trả về 400 invalid_size. Đường dẫn OpenAI tối đa là 1024p; sử dụng Tùy chọn A với resolution: "1080p" cho 1080p.

curl -s "https://apimaster.ai/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "Một thác nước tạo thành cầu vồng, điện ảnh",
    "seconds": "4",
    "size": "1280x720"
  }'

Phản hồi gửi

{
  "id": "task_xxxxxxxx",
  "object": "video",
  "model": "sora-2",
  "status": "queued"
}

Sử dụng task_id / id từ một trong hai điểm cuối để polling và tải xuống.

Poll trạng thái tác vụ

GET https://apimaster.ai/v1/videos/{task_id}

curl -s "https://apimaster.ai/v1/videos/task_xxxxxxxx" \
  -H "Authorization: Bearer YOUR_API_KEY"

Ví dụ đã hoàn thành:

{
  "id": "task_xxxxxxxx",
  "status": "completed",
  "url": "https://apimaster.ai/v1/videos/task_xxxxxxxx/content"
}

Tải xuống MP4 qua https://apimaster.ai/v1/videos/{task_id}/content.

Tải xuống video

curl -L "https://apimaster.ai/v1/videos/task_xxxxxxxx/content" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o output.mp4

Ví dụ chuyển hình ảnh thành video

Tùy chọn A:

curl -s "https://apimaster.ai/v1/videos/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "Slow push-in, gió nhẹ thổi qua tóc",
    "duration": 8,
    "resolution": "720p",
    "aspect_ratio": "9:16",
    "image_urls": ["https://example.com/reference.jpg"]
  }'

Tùy chọn B (trường images):

curl -s "https://apimaster.ai/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "Slow push-in, gió nhẹ thổi qua tóc",
    "seconds": "8",
    "images": ["https://example.com/reference.jpg"]
  }'

Mẹo khi polling

• Đợi 10–20 giây sau khi gửi; sau đó poll mỗi 3–5 giây
• Thời gian điển hình: 1–3 phút
• Lưu MP4 ngay sau khi hoàn thành

Mã lỗi

Mã	Ý nghĩa
400	Tham số không hợp lệ (ví dụ invalid_size)
401	Khóa API không hợp lệ
402	Số dư không đủ
429	Bị giới hạn tốc độ
500 / 502	Lỗi tạm thời, thử lại

Liên quan

• Tổng quan tạo video
• Lấy khóa API