Sora API——OpenAI 相容工作流程中的文字生成影片

Sora 是 OpenAI 的文字轉影片模型，而「Sora API」指的是團隊以程式方式生成影片，而不是透過消費者應用程式。在 Kunavo 上，目前的文字轉影片功能透過單一 OpenAI 風格影片端點使用Google Veo 3——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": "a cinematic dolly-in on a red origami crane unfolding, soft light",
        "aspect_ratio": "16:9",
    },
    timeout=600,  # generation can take minutes
)
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，立即取得 task id，然後輪詢 GET /v1/videos/{id} 直到完成。結果 URL 永久有效。

# Production: submit a task, then poll — no long-lived connection.
task = requests.post(
    "https://api.kunavo.com/v1/videos",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Idempotency-Key": "my-task-uuid",   # retry-safe within ~24h
    },
    json={"model": "veo-3", "prompt": "...", "aspect_ratio": "16:9"},
    timeout=60,
).json()
# then poll GET /v1/videos/{task["id"]} until it completes

影片文件涵蓋完整的輪詢流程、冪等金鑰與 webhook 傳送。

定價

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

影片提示撰寫技巧

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

常見問題