影片生成任務

API 概覽

影片生成是非同步操作：

1. 呼叫 POST /v1/videos/tasks 提交任務
2. 儲存回應中的公開任務 ID
3. 呼叫 GET /v1/tasks/{task_id} 查詢狀態與結果

Base URL 為 https://api.rokoapi.com/v1。所有請求都需攜帶 Authorization: Bearer $API_KEY。

已適配模型

實際可用範圍以 /v1/models、控制台通道設定與金鑰所屬分組為準。使用者僅需選擇產品模型；RokoAPI 會根據 generation_type 與素材欄位自動選擇 EvoLink 的文字生成、圖片生成、參考生成或編輯路由。

文字生成影片

curl https://api.rokoapi.com/v1/videos/tasks \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "generation_type": "text",
    "prompt": "A cinematic sunrise over snow mountains",
    "duration": 8,
    "quality": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'

圖片生成與參考生成影片

通常透過 image_urls、video_urls 與 audio_urls 傳入可由公網直接下載的素材：

{
  "model": "seedance-2.0",
  "generation_type": "reference",
  "prompt": "Keep the character identity and create a slow camera orbit",
  "image_urls": ["https://example.com/character.png"],
  "video_urls": ["https://example.com/motion.mp4"],
  "duration": 6,
  "quality": "720p",
  "aspect_ratio": "16:9"
}

例外：Wan 2.7 圖片生成影片使用 image_start 與可選的 image_end；Grok 1.5 根據 image_urls 數量自動選擇模式（0 張為文字生成、1 張為圖片生成、2～7 張為參考生成），不接受 aspect_ratio。

影片編輯

{
  "model": "wan-2.7",
  "generation_type": "edit",
  "prompt": "Change the background to a rainy neon street",
  "video_urls": ["https://example.com/input.mp4"],
  "image_urls": ["https://example.com/style.png"],
  "duration": 0,
  "quality": "720p"
}

Wan 2.7 編輯中的 duration: 0 表示跟隨輸入影片。Gemini Omni 編輯跟隨輸入影片，請勿傳送 duration 或 aspect_ratio。

參數邊界

請求中的額外模型參數會依原始 JSON 結構透傳給 EvoLink，包括 negative_prompt、generate_audio、content_filter、sound、prompt_extend 和 model_params。RokoAPI 會先驗證時長、畫質、畫幅、素材數量、回呼位址等已知邊界。影片介面不支援 n。

回呼與查詢

可選的 callback_url 必須為公開 HTTPS 位址，最長 2048 個字元，不能指向 localhost 或內網 IP。即使設定回呼，也建議保留輪詢作為容錯機制：

curl https://api.rokoapi.com/v1/tasks/task_public_id \
  -H "Authorization: Bearer $API_KEY"

常見狀態包括 queued、in_progress、completed 和 failed。結果連結可能有有效期限，生產環境應及時下載並轉存。

計費說明

模型採用統一 v2 美元表達式計費，可在一個公式中組合輸出秒數、輸入參考影片秒數、輸入圖片數量、音訊開關、解析度、畫質、生成方式和 Token 用量。提交時依經過驗證的參數預扣；任務完成後根據實際 Token 或輸出時長結算。

以下為 2026-08-20 固定售價快照，已包含 EvoLink 公示成本價的 10% 服務費，單位均為美元。價格不會隨上游積分即時變化；管理員審核上游調價後再更新本表和後台表達式。

Seedance 2.0 系列

Fast 與 Mini 的活動價來自 EvoLink 2026-08-07 調價，活動結束後不會自動改變 RokoAPI 售價，屆時以後台審核後的新快照為準。

其他按秒影片模型

Kling O3 同時依解析度和聲音開關計費：

Sora 2 系列

Gemini Omni Token 價格

參考影片時長只有在系統完成媒體元資料驗證或取得可信用量後才參與最終結算。完整價格以定價頁和後台目前設定為準。上游價格來源可參閱 EvoLink 模型目錄及各模型開發頁面。