Sora API — tạo video bằng AI (hiện dùng Veo 3.1)

Sora là model chuyển văn bản thành video của OpenAI, còn “Sora API” là cách các nhóm tạo video theo chương trình thay vì thông qua ứng dụng dành cho người tiêu dùng. Trên Kunavo, tính năng chuyển văn bản thành video hiện hoạt động với Google Veo 3 qua một endpoint video duy nhất theo phong cách OpenAI — quyền truy cập Sora nằm trong lộ trình, và vì endpoint độc lập với model nên việc chuyển sang Sora trong tương lai chỉ là thay đổi một từ. Hướng dẫn này minh họa quy trình với Veo 3 để mọi ví dụ đều chạy được ngay.

Sora API là gì?

Sora (Sora 2 và Sora 2 Pro) biến lời nhắc văn bản — hoặc một hình ảnh cố định — thành một đoạn video ngắn, kèm âm thanh đồng bộ trong Sora 2. Định dạng API cho phép bạn đưa quá trình tạo vào một pipeline: cảnh marketing, hoạt ảnh sản phẩm, b-roll, bản xem trước. Định dạng này giống nhau ở các model video hiện đại: gửi lời nhắc và tham số, nhận URL video được lưu trữ.

Video trên Kunavo hôm nay: Veo 3

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

Bắt đầu nhanh với chuyển văn bản thành video

Một yêu cầu POST duy nhất bằng khóa Kunavo của bạn. Quá trình tạo có thể mất vài phút; vì vậy cuộc gọi đồng bộ sẽ giữ kết nối cho đến khi clip 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": "kırmızı bir origami turnanın açılışına yumuşak ışıkta sinematik dolly-in",
        "aspect_ratio": "16:9",
    },
    timeout=600,  # üretim dakikalar sürebilir
)
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

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

Vòng đời tác vụ bất đồng bộ

Đừng giữ một kết nối trong 10 phút ở môi trường production. Gửi một tác vụ đến /v1/videos, nhận ngay ID tác vụ, sau đó thăm dò GET /v1/videos/{id} cho đến khi hoàn tất. Các URL kết quả là vĩnh viễn.

# Üretim: bir görev gönderin, sonra yoklayın — uzun ömürlü bağlantı yok.
task = requests.post(
    "https://api.kunavo.com/v1/videos",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Idempotency-Key": "my-task-uuid",   # yeniden gönderim aynı görevi döndürür
    },
    json={"model": "veo-3", "prompt": "...", "aspect_ratio": "16:9"},
    timeout=60,
).json()
# ardından tamamlanana kadar GET /v1/videos/{task["id"]} adresini yoklayın

Tài liệu video bao quát 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 video (ở đây hiển thị theo clip 8 giây 720p) và thấp hơn khoảng 50-70% so với giá niêm yết của Google. Độ phân giải cao hơn sẽ đắt hơn — xem trang giá để biết đầy đủ bảng cấp độ.

Mẹo viết lời nhắc cho video

• Hãy mô tả cảnh quay, không chỉ chủ thể. Chuyển động máy quay (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ừ.
• 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 một khung hình tham chiếu (chuyển hình ảnh thành video) — khi một nhân vật hoặc sản phẩm cụ thể cần được giữ nhất quán.

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