Sora API — 在相容於 OpenAI 的流程中將文字轉成影片

Sora 是 OpenAI 的文字轉影片模型，而「Sora API」是團隊以程式方式生成影片、而非透過消費者應用程式操作的方式。目前在 Kunavo，文字轉影片生成透過 Google Veo 3，使用單一 OpenAI 風格的影片端點——Sora 存取權已列入產品路線圖；由於該端點與模型無關，之後遷移至 Sora 時只需變更一個字。本指南展示使用 Veo 3 的工作流程，因此所有範例目前都能運作。

什麼是 Sora API？

Sora（Sora 2 與 Sora 2 Pro）會將文字提示——或靜態圖片——轉換為短片，Sora 2 還具備同步音訊。API 形式可讓您在管線中編排生成流程：行銷鏡頭、產品動畫、補充鏡頭、分鏡預覽。現代影片模型的格式都相同：傳送提示與參數後，會收到託管影片的 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": "um dolly-in cinematográfico em um origami de garça vermelha se abrindo, luz suave",
        "aspect_ratio": "16:9",
    },
    timeout=600,  # a geração pode levar minutos
)
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 永久有效。

# Produção: envie uma tarefa e faça polling — sem conexão de longa duração.
task = requests.post(
    "https://api.kunavo.com/v1/videos",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Idempotency-Key": "meu-uuid-de-tarefa",   # seguro para retry em ~24h
    },
    json={"model": "veo-3", "prompt": "...", "aspect_ratio": "16:9"},
    timeout=60,
).json()
# depois faça polling em GET /v1/videos/{task["id"]} até concluir

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

價格

Veo 3 按影片計費（此處顯示每段 8 秒、720p 影片），價格約比 Google 的牌價低 50–70%。更高解析度的費用較高——完整級距表請參閱價格頁面。

影片提示技巧

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

常見問題