Sora API — 使用 AI 生成影片（目前使用 Veo 3.1）

Sora 是 OpenAI 的文字轉影片模型，而「Sora API」是團隊以程式產生影片、而非使用消費者應用程式的方式。在 Kunavo，今天的文字轉影片功能透過單一 OpenAI 風格影片端點搭配 Google Veo 3 運作 — Sora 存取權已列入產品路線圖；由於端點與模型無關，未來切換至 Sora 時只需變更一個字。本指南使用 Veo 3 示範工作流程，確保每個範例現在都能立即運作。

什麼是 Sora API？

Sora（Sora 2 和 Sora 2 Pro）會將文字提示 — 或靜態影像 — 轉換為短影片片段；Sora 2 還會同步產生音訊。API 格式讓您能將生成工作寫入流程：行銷鏡頭、產品動畫、b-roll、草稿預覽。現代影片模型的格式相同：傳送提示和參數，取得託管的影片 URL。

Kunavo 今天的影片：Veo 3

Kunavo 透過單一 OpenAI 風格端點提供影片生成：/v1/video/generations。Sora 尚未在目錄中啟用；目前可用的文字轉影片模型是 Google Veo 3，可用原生音訊產生電影感片段。以下範例使用 veo-3 — Sora 上線後，唯一需要變更的是 model 欄位。

文字轉影片快速開始

使用 Kunavo 金鑰發出單一 POST。生成可能需要幾分鐘，因此同步呼叫會持續保持連線，直到片段就緒：

import requests

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（秒數）用來在按秒計費的模型（Seedance 系列模型和 Wan 2.7）上設定片段長度。Veo 模型會忽略它；每個 Veo 片段都是 8 秒，按影片計費。

影像轉影片

若要讓靜態影像動起來，請在提示中傳入 image_url（https URL 或您上傳至 /v1/files 的檔案）。您也可以透過 image_urls 和 image_mode: "frame" 傳入起始影格與結束影格，以控制動態。完整範例請見影片文件。

非同步任務生命週期

不要在生產環境中維持 10 分鐘的連線。向 /v1/videos 提交任務，立即取得任務 ID，然後持續輪詢 GET /v1/videos/{id}，直到完成。結果 URL 會永久有效。

# Ü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",   # ~24s içinde yeniden denemeye güvenli
    },
    json={"model": "veo-3", "prompt": "...", "aspect_ratio": "16:9"},
    timeout=60,
).json()
# ardından tamamlanana kadar GET /v1/videos/{task["id"]} adresini yoklayın

影片文件涵蓋完整的輪詢迴圈、冪等金鑰與 webhook 傳遞。

定價

Veo 3 按影片計費（此處以 720p、8 秒片段為例），價格約比 Google 公開定價低 %50-70。更高解析度的價格更高 — 完整層級表請參閱定價頁面。

影片提示詞技巧

• 描述鏡頭，而不只是描述主體。攝影機運動（dolly、pan、push-in）、鏡頭感、光線和節奏，比形容詞更重要。
• 明確指定長寬比 — 橫向使用 16:9，直向／社群媒體使用 9:16。
• 每個 Veo 片段都是 8 秒。請依這個長度規劃每個鏡頭；較長的序列可將多次生成串接起來。
• 使用參考影格（影像轉影片）— 當特定角色或產品需要保持一致時。

常見問題