Cách dùng Sora API — tạo video AI hoạt động ngay (Veo 3.1 / tương thích OpenAI)

Sora là mô hình tạo video từ văn bản của OpenAI, còn “Sora API” là cách tạo video bằng chương trình thay vì qua ứng dụng dành cho người tiêu dùng. Hiện tại trên Kunavo, việc tạo video từ văn bản hoạt động với Google Veo 3 qua một endpoint video theo phong cách OpenAI duy nhất——hỗ trợ Sora nằm trong lộ trình và endpoint không phụ thuộc mô hình, nên sau này chuyển sang Sora chỉ cần thay đổi một từ. Hướng dẫn này minh họa quy trình bằng 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 một ảnh tĩnh——thành các đoạn video ngắn, với âm thanh đồng bộ trong Sora 2. Dùng dưới dạng API, bạn có thể tích hợp việc tạo video vào pipeline, chẳng hạn như video marketing, hoạt ảnh sản phẩm, b-roll và bản xem trước storyboard. Cấu trúc này phổ biến với các mô hình video hiện đại: gửi prompt và tham số, rồi nhận 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; mô hình tạo video từ văn bản hiện có là Google Veo 3, tạo các clip điện ảnh với âm thanh tích hợp sẵn. Các ví dụ bên dưới dùng veo-3——khi Sora xuất hiện, bạn chỉ cần thay đổi trường model.

Bắt đầu nhanh với video từ văn bản

Chỉ cần một yêu cầu POST bằng khóa Kunavo. Vì quá trình tạo có thể mất vài phút, lệnh 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": "a cinematic dolly-in on a red origami crane unfolding, soft light",
        "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.

Từ hình ảnh sang video

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

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

Trong production, không nên giữ kết nối trong 10 phút. Gửi tác vụ đến /v1/videos sẽ trả về ID tác vụ ngay lập tức; sau đó polling 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 giải thích toàn bộ vòng lặp polling, khóa idempotency và việc phân phối webhook.

Giá

Veo 3 được tính phí theo video (ở đây là mỗi clip 8 giây 720p), rẻ 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ăng chi phí——xem bảng đầy đủ các cấp tại trang giá.

Mẹo viết prompt video

• Mô tả cả cảnh quay, không chỉ chủ thể. Chuyển động máy quay (dolly, pan, push-in), chất lượng ống kính, ánh sáng và nhịp độ có tác dụng hơn tính từ.
• Nêu rõ tỷ lệ khung hình——16:9 cho khung ngang, 9:16 cho khung 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.
• Dùng khung hình tham chiếu (hình ảnh sang 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