視頻生成

視頻生成是異步的。 POST /v1/videos/generations 返回一個公共任務身份，通常還會返回一個 poll_url；最終視頻會在後續的狀態響應中出現。

可在所選模型支援的圖片欄位中傳入公開 HTTP(S) URL 或支援的 data URL。這些輸入沿一般媒體路徑處理，不會自動建立可重用的素材 ID。

明確指定的素材仍在準備時，POST /v1/videos/generations 回傳 409 seedance_material_preparing，並以 inactive_asset_ids 列出相關素材。查詢直到 ACTIVE，再用相同素材 ID 重試。若為 FAILED，先依 error_message 修正或重新匯入。

支援的操作Copy Anchor Link

在生產中使用明確的 operation。TokenLab 可以從輸入中推斷某些操作，但明確的操作值使得驗證、支持和重試更加清晰。

模型發現Copy Anchor Link

curl "https://api.tokenlab.sh/v1/models?recommended_for=video" \
  -H "Authorization: Bearer sk-your-api-key"

model 應使用 TokenLab 顯示的模型 ID，再用 operation 和對應媒體輸入選擇操作能力。示例包括 wan-2.7、happyhorse-1.0、viduq3、viduq3-mix、pixverse-v6、veo3.1、seedance-2.0；不要把供應商的操作名稱當成 TokenLab 模型名。

在依賴於專用字段如 reference_images、kling_elements、output_audio、duration、resolution 或 aspect_ratio 之前，請閱讀所選模型的詳細信息。

創建請求Copy Anchor Link

curl https://api.tokenlab.sh/v1/videos/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo3.1",
    "operation": "text-to-video",
    "prompt": "一隻貓在陽光明媚的花園中漫步的平靜電影鏡頭",
    "duration": 4,
    "aspect_ratio": "16:9"
  }'

對於生產媒體輸入，優先使用公共 https URL，而不是內聯 data: URL。如果使用臨時存取 URL，請確保它在 TokenLab 完成任務建立前保持有效。

輸入和模型特定字段Copy Anchor Link

音訊行為取決於所選模型和操作。沒有音訊開關，不代表影片必須無聲；省略參數也不等於傳送 false。

• veo3.1 和 veo3.1-fast 依 Gemini API 契約始終產生音訊。wan-2.6 和 wan-2.7 的影片生成也不支援關閉聲音。省略 output_audio；模型詳情允許時亦可設為 true。
• hailuo-h3 和 Grok 影片模型原生產生音訊。請勿加入所選模型詳情未列出的音訊開關。
• Seedance 1.5/2.x 與 viduq3-pro / viduq3-turbo 預設開啟音訊，並支援無聲輸出；PixVerse C1/V5.6/V6 預設關閉音訊。僅在目前操作列出該欄位時使用 output_audio；Vidu 亦接受其契約宣告的布林欄位 audio。
• audio_url / audio_urls 用於輸入或參考音訊，不是輸出聲音開關。影片編輯、動作遷移和風格轉換可能保留輸入音軌；保留原音不等於靜音。

允許值及音訊相關價格以模型詳情為準。受支援的相容欄位 outputAudio、generate_audio 和布林 audio 與 output_audio 同時出現時，值必須一致。請勿假定同系列各版本、各操作的聲音控制相同。

• 使用 Seedance 2.0 家族的 4K 輸出、Fast/Mini 解析度邊界或多模態參考輸入前，請閱讀 Seedance 2.0 影片模型指南。
• grok-imagine-video 的 video-to-video 使用 prompt 與公開 HTTPS .mp4 video_url；此操作不使用 duration、resolution 或 aspect_ratio 選項。

PixVerse 與 HappyHorseCopy Anchor Link

在 TokenLab 上，上述 PixVerse 模型不接受 operation=video-extension。

curl https://api.tokenlab.sh/v1/videos/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-v6",
    "operation": "image-to-video",
    "prompt": "A slow camera move through a neon-lit street",
    "image_url": "https://example.com/start.jpg",
    "resolution": "1080p",
    "duration": 5,
    "output_audio": true
  }'

輪詢結果Copy Anchor Link

首先使用返回的 poll_url。如果您需要固定端點，請使用 GET /v1/tasks/{id}，並使用來自創建響應的相同 id / task_id。

完成的影片任務可能會根據模型和輸出數量返回 video_url、video 或 videos。請將 billing_transaction_id 視為計費識別符，而不是任務識別符。

常見陷阱Copy Anchor Link

• 不要硬編碼舊的視頻狀態路徑；優先使用 poll_url。
• 除非模型說明允許，否則不要將第一幀字段與專用的參考圖像流結合使用。
• 不要假設 duration 描述輸入參考視頻的長度；它通常控制生成的輸出長度。
• 在超時後不要重試創建請求，而不檢查任務是否已經創建。

API 參考Copy Anchor Link

統一影片 API 與火山相容入口Copy Anchor Link

跨模型影片生成建議使用 /v1/videos/generations。如果你正在遷移既有 Seedance 2.0 整合，且請求已是火山風格 content[] 或 Action 形式，可以使用 /api/v3 下的 Seedance 相容入口。兩種入口都使用 TokenLab Bearer API Key 和非同步輪詢，但請求與回應結構不同。

OpenAI 風格和火山相容影片 APICopy Anchor Link

跨模型影片生成請使用 TokenLab 統一的 /v1/videos/generations。如果你正在遷移已經使用火山風格 content[] 或 Action 請求的 Seedance 2.0 整合，可以使用 /api/v3 下的 Seedance 相容入口。兩種入口都使用 TokenLab Bearer API Key 和異步輪詢，但請求與回應結構不同。

{
  "model": "hailuo-h3-max",
  "operation": "text-to-video",
  "prompt": "A slow camera move through a quiet garden",
  "resolution": "768p",
  "duration": 5,
  "aspect_ratio": "16:9"
}