Hướng dẫn Sora API — tạo video AI dùng ngay (Veo 3.1)

Sora là model text-to-video của OpenAI, còn “Sora API” là cách tạo video theo lập trình thay vì qua ứng dụng dành cho người tiêu dùng. Hiện tại, text-to-video trên Kunavo chạy bằng Google Veo 3 thông qua một endpoint video theo phong cách OpenAI — hỗ trợ Sora nằm trong lộ trình, và vì endpoint không phụ thuộc model nên sau này chuyển sang Sora chỉ cần thay đổi một từ. Hướng dẫn này trình bày quy trình với Veo 3 để mọi ví dụ đều có thể chạy ngay.

Sora API là gì?

Sora (Sora 2 và Sora 2 Pro) chuyển prompt văn bản hoặc ảnh tĩnh thành các đoạn video ngắn, đồng thời cung cấp âm thanh đồng bộ trong Sora 2. Ở dạng API, bạn có thể lập trình việc tạo video vào quy trình: cảnh marketing, hoạt ảnh sản phẩm, b-roll, bản xem trước storyboard. Các model video hiện đại đều có hình thức giống nhau: gửi prompt và tham số, rồi nhận về URL video được lưu trữ.

Video hiện có trên Kunavo: Veo 3

Kunavo cung cấp tính năng tạo video qua một endpoint theo phong cách OpenAI duy nhất /v1/video/generations. Sora chưa được kích hoạt trong danh mục, còn mô hình chuyển văn bản thành video hiện có là Google Veo 3, tạo các đoạn phim giàu tính điện ảnh kèm âm thanh tích hợp sẵn. Các ví dụ bên dưới sử dụng veo-3 — khi Sora được thêm vào, trường duy nhất cần thay đổi là model.

Bắt đầu nhanh với text-to-video

Chỉ cần một yêu cầu POST bằng khóa Kunavo. Việc tạo có thể mất vài phút, vì vậy lệnh gọi đồng bộ sẽ giữ kết nối cho đến khi đoạn video sẵn sàng:

import os

import requests

API_KEY = os.environ["KUNAVO_API_KEY"]

resp = requests.post(
    "https://api.kunavo.com/v1/video/generations",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "veo-3",
        "prompt": "빨간 종이학이 펼쳐지는 영화적인 돌리인, 부드러운 조명",
        "aspect_ratio": "16:9",
    },
    timeout=600,  # 생성에 몇 분이 걸릴 수 있습니다
)
print(resp.json()["data"][0]["url"])

duration (giây) đặt độ dài clip trên các mô hình tính phí theo giây: các mô hình Seedance và mô hình Wan 2.7. Các mô hình Veo bỏ qua tham số này; mỗi clip Veo dài 8 giây và được tính phí theo video.

Chuyển hình ảnh thành video

Để tạo chuyển động cho ảnh tĩnh, hãy truyền image_url (URL https hoặc /v1/files tệp đã tải lên) cùng với prompt. Để tạo chuyển động có kiểm soát, bạn có thể truyền khung hình đầu và cuối bằng image_urls và image_mode: "frame". Ví dụ đầy đủ có trong tài liệu video.

Vòng đời công việc không đồng bộ

Trong production, đừng duy trì một kết nối trong 10 phút. Gửi công việc đến /v1/videos, nhận ngay ID công việc và thăm dò GET /v1/videos/{id} cho đến khi hoàn tất. URL kết quả là vĩnh viễn.

# 프로덕션: 작업을 제출한 뒤 폴링 — 장시간 연결을 유지하지 않습니다.
task = requests.post(
    "https://api.kunavo.com/v1/videos",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Idempotency-Key": "my-task-uuid",   # 다시 제출해도 같은 작업이 반환됩니다
    },
    json={"model": "veo-3", "prompt": "...", "aspect_ratio": "16:9"},
    timeout=60,
).json()
# 이후 완료될 때까지 GET /v1/videos/{task["id"]} 폴링

Tài liệu video trình bày toàn bộ vòng lặp thăm dò, khóa idempotency và việc phân phối webhook.

Giá

Veo 3 được tính phí theo từng video (ở đây dựa trên đoạn 8 giây 720p) và rẻ hơn khoảng 50–70% so với bảng giá của Google. Độ phân giải cao hơn sẽ làm tăng chi phí — xem trang giá để biết bảng đầy đủ các cấp.

Mẹo viết prompt video

• Hãy mô tả cả cảnh quay, không chỉ chủ thể. Chuyển động camera (dolly, pan, push-in), cảm giác ống kính, ánh sáng và nhịp độ quan trọng hơn tính từ.
• Hãy chỉ rõ tỷ lệ khung hình — 16:9 cho ngang, 9:16 cho dọc/mạng xã hội.
• Mỗi clip Veo dài 8 giây. Hãy lên kế hoạch cho từng cảnh quay theo độ dài đó, và ghép kết quả của nhiều lần tạo để có các chuỗi cảnh dài hơn.
• Sử dụng khung hình tham chiếu (image-to-video). Hữu ích khi cần giữ nhất quán một nhân vật hoặc sản phẩm cụ thể.

Câu hỏi thường gặp