Can the Vidu Q3 API generate dialogue, music, and video together?

是。Vidu Q3 原生即可同步輸出影片、對話、旁白、音效與背景音樂，無需另行進行獨立的音訊製作。

What is the maximum video length supported by Vidu Q3 API?

Vidu Q3 每次生成支援 1 至 16 秒的影片時長，並在整個片段中保持聲畫同步。

When should I choose Vidu Q3 instead of Vidu Q3 Turbo?

當輸出品質、敘事一致性與電影級敘事比生成速度更重要時，請選擇 Vidu Q3。Q3 Turbo 已針對更快速的迭代進行最佳化。

Does the Vidu Q3 API support image-to-video generation?

是。Vidu Q3 支援以圖生影片的工作流程，將靜態圖像轉換為動態序列，同時保留視覺識別與場景一致性。

Can Vidu Q3 create multi-character conversations with synchronized speech?

是。Vidu Q3 的關鍵能力之一是支援多說話者對話生成，並提供音訊與視覺的同步輸出。

What resolutions are available in the Vidu Q3 API?

該模型支援以 24 FPS 生成 540p、720p 與 1080p 的影片。

Is Vidu Q3 suitable for AI short films and narrative advertising?

是。Vidu Q3 專為故事驅動的內容而設計，例如短劇、電影級場景、敘事型廣告與漫畫風格作品。

What are the main limitations of the Vidu Q3 API?

單次生成限制為 16 秒，因此較長的作品需要透過多個片段與後期剪輯來打造更長的敘事。

Vidu

可使用

viduq3

Vidu Q3 API

Vidu Q3 是一款專為高品質內容創作而設計的影片生成模型，具備出色的視覺真實感與高提示遵循度。它適用於創意影片製作與故事敘事等應用。

起始價格

$0.056 / 秒

按使用量計費

API 健康狀態

可使用

正式環境端點

回應時間

支援非同步

實測 API 回應時間

發布時間

May 31, 2026

Vidu

概覽

Vidu Q3 的實用總覽,涵蓋重要行為與整合注意事項。

Vidu Q3 的技術規格

項目	Vidu Q3 (viduq3-pro)
Model ID	viduq3-pro
Provider	Vidu
Model Family	Vidu Q3 Series
Model Type	AI 影片生成
Input Types	文字、圖片、起始圖片 + 結束圖片
Output Type	具原生同步音訊的影片
Resolution	540p, 720p, 1080p
Duration	1–16 秒
Frame Rate	24 FPS
Audio Generation	原生音訊-視訊生成
Text-to-Video	支援
Image-to-Video	支援
Start-End-to-Video	支援
Intelligent Shot Switching	支援
Primary Focus	敘事講述與電影風格影片創作

什麼是 Vidu Q3？

Vidu Q3 是 Vidu 旗艦的第三代影片模型，專為以故事驅動的影片生成而打造。不同於傳統先生成畫面再生成音訊的 AI 影片系統，Vidu Q3 能同時生成對白、旁白、音效、音樂與影片，讓單一生成流程即可實現同步敘事。該模型適用於短劇、電影式片段、廣告內容，以及以角色為主導的敘事作品。

Vidu Q3 的主要功能

原生音視同步：與影片同時生成對白、旁白、音效與音樂。
16 秒連續生成：單次生成即可產出完整敘事片段。
逐幀精準相機控制：支援對相機運動、節奏與場景構圖的細緻控制。
多說話者對話支援：為對話與角色互動而設計。
多語言生成：支援英語、日語與中文內容生成。
電影式敘事優化：針對戲劇、電影風格內容、漫畫與敘事型廣告進行調校。

Vidu Q3 的基準表現

與語言模型不同，Vidu Q3 不公布 MMLU 或 SWE-Bench 等標準化基準分數。公開揭露的效能指標包括：

指標	公開資訊
最長時長	16 seconds
最高解析度	1080p
原生音訊生成	Yes
多說話者對話	Yes
多語言支援	English, Japanese, Chinese
逐幀相機控制	Yes

Artificial Analysis 分數為 1241，並位列全球領先的影片生成系統之列，但獨立基準驗證仍然有限。

Vidu Q3、Vidu Q3 Turbo 與 Kling 2.1 比較

功能	Vidu Q3	Vidu Q3 Turbo	Kling 2.1
定位	高端品質	速度優化	通用影片生成
原生音訊	Yes	Yes	取決於工作流程
最長時長	16s	16s	Varies
解析度	Up to 1080p	Up to 1080p	Up to 1080p
相機控制	Advanced	Advanced	Strong
敘事側重	Highest	Moderate	Strong
生成速度	Standard	Faster	Competitive

已知限制

單支片段仍限於 16 秒。
長片製作需要組合多次生成結果。
與領先的 LLM 供應商相比，公開基準透明度仍有限。
敘事品質高度依賴提示設計與場景規劃。

代表性使用案例

AI 短片

生成含同步語音、環境音與音樂的電影感場景。

短劇製作

無需分離音訊製作流程，即可創作連載短劇內容。

廣告與品牌敘事

製作整合旁白與聲音設計的敘事型廣告。

漫畫與日本漫畫改編

將分鏡與插圖轉化為具敘事性的動畫片段。

社群媒體影片創作

生成可直接發布到 TikTok、Shorts 與 Reels 的同步音訊影片內容。

模型版本說明

Vidu Q3 為 Q3 家族中的高階版本。與 Vidu Q3 Turbo 相比，標準版 Q3 模型更優先考量輸出品質、敘事一致性與電影式敘事，而非生成速度。兩者皆支援原生音訊與視訊輸出，並可生成最長 16 秒的影片。

如何在 CometAPI 上存取與部署 viduq3 API

步驟 1：註冊或登入 CometAPI 並取得您的 viduq3 API 金鑰

建立您的 CometAPI 帳號或登入既有帳號，以在 API 可用時存取。發佈後，您將能從平台取得 HappyHorse-1.0 API 金鑰，並準備進行測試或整合。

步驟 2：在 Playground 免費測試 viduq3 API

在部署前，您可以直接在 CometAPI 的 Playground 試用 viduq3 API。這能輕鬆評估輸出品質、測試提示或圖片輸入，並在投入生產前更清楚了解 API 的效能。

步驟 3：在生產環境部署 viduq3 API

測試完成後，下一步是將 viduq3 API 部署到您自己的應用、產品或內部環境。在真實的影片生成場景中，穩定存取與實際整合至關重要。

常見問題

定價

先參考上方的單次執行預估,再查看完整的 CometAPI 與官方價格比較。

5 秒測試

$0.28

預估 CometAPI 使用費用

10 秒測試

$0.56

預估 CometAPI 使用費用

15 秒測試

$0.84

預估 CometAPI 使用費用

Vidu Q3 的定價

探索 Vidu Q3 的競爭性定價，專為滿足各種預算和使用需求而設計。我們靈活的方案確保您只需為實際使用量付費，讓您能夠隨著需求增長輕鬆擴展。了解 Vidu Q3 如何在保持成本可控的同時提升您的專案效果。

Vidu Video Generation Pricing

Pricing (Per Second)

Model	360p	540p	720p	1080p
`viduq3`	$0.056	$0.056	$0.1232	$0.1232
`viduq3-turbo`	$0.028	$0.028	$0.0616	$0.0616

💡 Billed per second. Total cost = price per second × video duration (seconds).

API

複製可用的端點與程式碼範例,需要完整參數時再開啟完整 API 參考文件。

一個 API,直接對接正式環境模型

只需驗證一次,即可呼叫模型端點,並在各供應商間維持一致的計費與監控流程。

POST/v1/videos

Vidu Q3 的範例程式碼和 API

存取完整的範例程式碼和 API 資源，以簡化您的 Vidu Q3 整合流程。我們詳盡的文件提供逐步指引，協助您在專案中充分發揮 Vidu Q3 的潛力。

POST

/v1/videos

# Create a video with viduq3
# Step 1: Submit the video generation request
echo "Submitting video generation request..."
response=$(curl -s https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F "model=viduq3" \
  -F "prompt=Ultra-realistic cinematic shot of an astronaut walking slowly through soft fog, volumetric light in light blue and pale amber tones, shallow depth of field, 35mm film texture, graceful camera movement." \
  -F "seconds=1" \
  -F "size=960x528")

echo "Response: $response"

# Extract video_id from response (handle JSON with spaces like "id": "xxx")
video_id=$(echo "$response" | tr -d '
' | sed 's/.*"id"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/')
echo "Video ID: $video_id"

# Step 2: Poll for progress until 100%
echo ""
echo "Checking video generation progress..."
while true; do
  status_response=$(curl -s "https://api.cometapi.com/v1/videos/$video_id" \
    -H "Authorization: Bearer $COMETAPI_KEY")

  progress=$(echo "$status_response" | grep -o '"progress"[[:space:]]*:[[:space:]]*"\?[^",}]*"\?' | head -1 | sed 's/.*:[[:space:]]*"\?//;s/"$//')
  status=$(echo "$status_response" | grep -o '"status"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*"status"[[:space:]]*:[[:space:]]*"//;s/"$//')

  echo "Progress: $progress, Status: $status"

  if [ "$status" = "FAILURE" ] || [ "$status" = "failed" ] || [ "$status" = "error" ]; then
    echo "Video generation failed!"
    exit 1
  fi

  if [ "$progress" = "100%" ] || [ "$progress" = "100" ] || [ "$status" = "completed" ] || [ "$status" = "success" ]; then
    echo "Video generation completed!"
    break
  fi

  sleep 10
done

# Step 3: Download the video to output directory
echo ""
echo "Downloading video to ./output/$video_id.mp4..."
mkdir -p ./output
curl -s "https://api.cometapi.com/v1/videos/$video_id/content" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -o "./output/$video_id.mp4"

if [ -f "./output/$video_id.mp4" ]; then
  echo "Video saved to ./output/$video_id.mp4"
  ls -la "./output/$video_id.mp4"
else
  echo "Failed to download video"
  exit 1
fi

cURL Code Example

# Create a video with viduq3
# Step 1: Submit the video generation request
echo "Submitting video generation request..."
response=$(curl -s https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F "model=viduq3" \
  -F "prompt=Ultra-realistic cinematic shot of an astronaut walking slowly through soft fog, volumetric light in light blue and pale amber tones, shallow depth of field, 35mm film texture, graceful camera movement." \
  -F "seconds=1" \
  -F "size=960x528")

echo "Response: $response"

# Extract video_id from response (handle JSON with spaces like "id": "xxx")
video_id=$(echo "$response" | tr -d '\n' | sed 's/.*"id"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/')
echo "Video ID: $video_id"

# Step 2: Poll for progress until 100%
echo ""
echo "Checking video generation progress..."
while true; do
  status_response=$(curl -s "https://api.cometapi.com/v1/videos/$video_id" \
    -H "Authorization: Bearer $COMETAPI_KEY")
  
  progress=$(echo "$status_response" | grep -o '"progress"[[:space:]]*:[[:space:]]*"\?[^",}]*"\?' | head -1 | sed 's/.*:[[:space:]]*"\?//;s/"$//')
  status=$(echo "$status_response" | grep -o '"status"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*"status"[[:space:]]*:[[:space:]]*"//;s/"$//')
  
  echo "Progress: $progress, Status: $status"
  
  if [ "$status" = "FAILURE" ] || [ "$status" = "failed" ] || [ "$status" = "error" ]; then
    echo "Video generation failed!"
    exit 1
  fi
  
  if [ "$progress" = "100%" ] || [ "$progress" = "100" ] || [ "$status" = "completed" ] || [ "$status" = "success" ]; then
    echo "Video generation completed!"
    break
  fi
  
  sleep 10
done

# Step 3: Download the video to output directory
echo ""
echo "Downloading video to ./output/$video_id.mp4..."
mkdir -p ./output
curl -s "https://api.cometapi.com/v1/videos/$video_id/content" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -o "./output/$video_id.mp4"

if [ -f "./output/$video_id.mp4" ]; then
  echo "Video saved to ./output/$video_id.mp4"
  ls -la "./output/$video_id.mp4"
else
  echo "Failed to download video"
  exit 1
fi

Python Code Example

# Create a video with viduq3 using raw HTTP requests
import os
import time
import requests

api_key = os.environ.get("COMETAPI_KEY")
base_url = "https://api.cometapi.com/v1"
headers = {"Authorization": f"Bearer {api_key}"}

# Step 1: Submit the video generation request
print("Submitting video generation request...")
response = requests.post(
    f"{base_url}/videos",
    headers=headers,
    files={
        "model": (None, "viduq3"),
        "prompt": (None, "Ultra-realistic cinematic shot of an astronaut walking slowly through soft fog, volumetric light in light blue and pale amber tones, shallow depth of field, 35mm film texture, graceful camera movement."),
        "seconds": (None, "1"),
        "size": (None, "960x528"),
    },
)

result = response.json()
print(f"Response: {result}")

video_id = result.get("id") or result.get("task_id")
print(f"Video ID: {video_id}")

# Step 2: Poll for progress until 100%
print("\nChecking video generation progress...")
while True:
    try:
        status_response = requests.get(f"{base_url}/videos/{video_id}", headers=headers)
        status_result = status_response.json()

        data = status_result.get("data") or status_result
        progress = data.get("progress", "0%")
        status = data.get("status", "unknown")

        print(f"Progress: {progress}, Status: {status}")

        if status in ["FAILURE", "failed", "error"]:
            print("Video generation failed!")
            print(status_result)
            exit(1)

        if progress == "100%" or progress == 100 or status in ["completed", "success"]:
            print("Video generation completed!")
            break
    except Exception as e:
        print(f"Temporary error: {e}, retrying...")

    time.sleep(10)

# Step 3: Download the video to output directory
print(f"\nDownloading video to ./output/{video_id}.mp4...")
os.makedirs("./output", exist_ok=True)

video_response = requests.get(f"{base_url}/videos/{video_id}/content", headers=headers)

output_path = f"./output/{video_id}.mp4"
with open(output_path, "wb") as f:
    f.write(video_response.content)

if os.path.exists(output_path):
    file_size = os.path.getsize(output_path)
    print(f"Video saved to {output_path}")
    print(f"File size: {file_size} bytes")
else:
    print("Failed to download video")
    exit(1)

JavaScript Code Example

// Create a video with viduq3 using raw HTTP requests
import fs from "fs";
import path from "path";

const apiKey = process.env.COMETAPI_KEY;
const baseUrl = "https://api.cometapi.com/v1";
const headers = { Authorization: `Bearer ${apiKey}` };

function sleep(ms) {
  return new Promise((resolve) => setTimeout(resolve, ms));
}

// Step 1: Submit the video generation request
console.log("Submitting video generation request...");
const formData = new FormData();
formData.append("model", "viduq3");
formData.append("prompt", "Ultra-realistic cinematic shot of an astronaut walking slowly through soft fog, volumetric light in light blue and pale amber tones, shallow depth of field, 35mm film texture, graceful camera movement.");
formData.append("seconds", "1");
formData.append("size", "960x528");

const submitResponse = await fetch(`${baseUrl}/videos`, {
  method: "POST",
  headers,
  body: formData,
});

const result = await submitResponse.json();
console.log("Response:", JSON.stringify(result, null, 2));

const videoId = result.id || result.task_id;
console.log("Video ID:", videoId);

// Step 2: Poll for progress until 100%
console.log("\nChecking video generation progress...");
while (true) {
  try {
    const statusResponse = await fetch(`${baseUrl}/videos/${videoId}`, { headers });
    const statusResult = await statusResponse.json();
    const data = statusResult.data || statusResult;
    const progress = data.progress || "0%";
    const status = data.status || "unknown";

    console.log(`Progress: ${progress}, Status: ${status}`);

    if (status === "FAILURE" || status === "failed" || status === "error") {
      console.log("Video generation failed!");
      console.log(JSON.stringify(statusResult, null, 2));
      process.exit(1);
    }

    if (progress === "100%" || progress === 100 || status === "completed" || status === "success") {
      console.log("Video generation completed!");
      break;
    }
  } catch (e) {
    console.log(`Temporary error: ${e.message}, retrying...`);
  }

  await sleep(10000);
}

// Step 3: Download the video to output directory
console.log(`\nDownloading video to ./output/${videoId}.mp4...`);
fs.mkdirSync("./output", { recursive: true });

const videoResponse = await fetch(`${baseUrl}/videos/${videoId}/content`, { headers });
const outputPath = path.join("./output", `${videoId}.mp4`);
fs.writeFileSync(outputPath, Buffer.from(await videoResponse.arrayBuffer()));

if (fs.existsSync(outputPath)) {
  const stats = fs.statSync(outputPath);
  console.log(`Video saved to ${outputPath}`);
  console.log(`File size: ${stats.size} bytes`);
} else {
  console.log("Failed to download video");
  process.exit(1);
}

功能

在選擇架構或評估正式環境負載前,先掌握模型的關鍵資訊。

支援的功能

現有模型 API 回傳的功能。

text-to-video

image-to-video

輸入與輸出

輸入

text

輸出

video

正式環境資訊

供應商: Vidu
上下文: 依模型而定
商業使用: 支援

應用場景

將 Vidu Q3 用於符合其 video 能力的正式工作流程,並在長期整合前比較其他選項。

文字轉影片的概念與社群內容

產品展示與電影感分鏡

圖像轉影片動態與創意迭代

其他模型

比較 CometAPI 提供的其他模型,在品質、延遲、功能與價格間取得平衡。

開啟模型比較 →

MiniMax

MiniMax H3

minimax-h3 是一款為高品質創意製作而設計的全新影片生成模型。它在提示詞理解、視覺一致性、畫面運動的流暢度，以及參考圖像控制的靈活性方面均有提升，適用於電影級影片生成工作流程。

查看模型

Aliyun

Happy Horse 1.1

HappyHorse 1.1 是一款面向專業內容創作、廣告、短片、社群媒體製作與敘事的多模態影片生成模型。它在 HappyHorse 1.0 的基礎上擴展能力——該版本曾在獨立的影片生成評測中名列前茅，因而獲得廣泛關注——並具備更強的場景連貫性與更高的視覺保真度。

查看模型

Bytedance

Seedance 2-0

Seedance 2.0 是 ByteDance 的新一代多模態影片基礎模型，聚焦於電影級、多鏡頭敘事的影片生成。有別於單鏡頭的文本轉影片示範，Seedance 2.0 著重於基於參考的控制（圖像、短片、音訊）、跨鏡頭的角色與風格一致性，以及原生的聲畫同步——旨在使 AI 影片可用於專業創作與預視化工作流程。

查看模型

Aliyun

Happy Horse 1.0

Happy Horse 1.0 — 一款高品質的影音生成模型，支援文字轉影片與圖片轉影片創作。它可生成畫面、音訊與口型的同步效果，適用於短片、廣告創意與產品展示。

查看模型

Google

Gemini omni fast

Gemini Omni Fast 是一款輕量級多模態影片生成模型，旨在用於快速且靈活的內容創作。它支援多種輸入類型，可高效生成影片，適用於互動式與迭代式的工作流程。

查看模型

Vidu

Vidu Q3 Turbo

Vidu Q3 Turbo 是 Vidu Q3 的優化版本，旨在提供更快的影片生成。它在顯著提升速度的同時保持良好的視覺品質，使其適用於快速迭代與大規模生產。

查看模型

Uptime

在正式上線前,查看即時心跳資料、端點可用性與實測回應時間。

版本

在鎖定正式環境整合版本前,先查看可用的模型識別碼。

viduq3

viduq3-turbo

持續探索

比較模型,繼續你的研究

Vidu

可使用

viduq3

Vidu Q3 API

Vidu Q3 是一款專為高品質內容創作而設計的影片生成模型，具備出色的視覺真實感與高提示遵循度。它適用於創意影片製作與故事敘事等應用。

起始價格

$0.056 / 秒

按使用量計費

API 健康狀態

可使用

正式環境端點

回應時間

支援非同步

實測 API 回應時間

發布時間

May 31, 2026

Vidu

概覽

Vidu Q3 的實用總覽,涵蓋重要行為與整合注意事項。

Vidu Q3 的技術規格

項目	Vidu Q3 (viduq3-pro)
Model ID	viduq3-pro
Provider	Vidu
Model Family	Vidu Q3 Series
Model Type	AI 影片生成
Input Types	文字、圖片、起始圖片 + 結束圖片
Output Type	具原生同步音訊的影片
Resolution	540p, 720p, 1080p
Duration	1–16 秒
Frame Rate	24 FPS
Audio Generation	原生音訊-視訊生成
Text-to-Video	支援
Image-to-Video	支援
Start-End-to-Video	支援
Intelligent Shot Switching	支援
Primary Focus	敘事講述與電影風格影片創作

什麼是 Vidu Q3？

Vidu Q3 的主要功能

原生音視同步：與影片同時生成對白、旁白、音效與音樂。
16 秒連續生成：單次生成即可產出完整敘事片段。
逐幀精準相機控制：支援對相機運動、節奏與場景構圖的細緻控制。
多說話者對話支援：為對話與角色互動而設計。
多語言生成：支援英語、日語與中文內容生成。
電影式敘事優化：針對戲劇、電影風格內容、漫畫與敘事型廣告進行調校。

Vidu Q3 的基準表現

與語言模型不同，Vidu Q3 不公布 MMLU 或 SWE-Bench 等標準化基準分數。公開揭露的效能指標包括：

指標	公開資訊
最長時長	16 seconds
最高解析度	1080p
原生音訊生成	Yes
多說話者對話	Yes
多語言支援	English, Japanese, Chinese
逐幀相機控制	Yes

Artificial Analysis 分數為 1241，並位列全球領先的影片生成系統之列，但獨立基準驗證仍然有限。

Vidu Q3、Vidu Q3 Turbo 與 Kling 2.1 比較

功能	Vidu Q3	Vidu Q3 Turbo	Kling 2.1
定位	高端品質	速度優化	通用影片生成
原生音訊	Yes	Yes	取決於工作流程
最長時長	16s	16s	Varies
解析度	Up to 1080p	Up to 1080p	Up to 1080p
相機控制	Advanced	Advanced	Strong
敘事側重	Highest	Moderate	Strong
生成速度	Standard	Faster	Competitive

已知限制

單支片段仍限於 16 秒。
長片製作需要組合多次生成結果。
與領先的 LLM 供應商相比，公開基準透明度仍有限。
敘事品質高度依賴提示設計與場景規劃。

代表性使用案例

AI 短片

生成含同步語音、環境音與音樂的電影感場景。

短劇製作

無需分離音訊製作流程，即可創作連載短劇內容。

廣告與品牌敘事

製作整合旁白與聲音設計的敘事型廣告。

漫畫與日本漫畫改編

將分鏡與插圖轉化為具敘事性的動畫片段。

社群媒體影片創作

生成可直接發布到 TikTok、Shorts 與 Reels 的同步音訊影片內容。

模型版本說明

如何在 CometAPI 上存取與部署 viduq3 API

步驟 1：註冊或登入 CometAPI 並取得您的 viduq3 API 金鑰

建立您的 CometAPI 帳號或登入既有帳號，以在 API 可用時存取。發佈後，您將能從平台取得 HappyHorse-1.0 API 金鑰，並準備進行測試或整合。

步驟 2：在 Playground 免費測試 viduq3 API

在部署前，您可以直接在 CometAPI 的 Playground 試用 viduq3 API。這能輕鬆評估輸出品質、測試提示或圖片輸入，並在投入生產前更清楚了解 API 的效能。

步驟 3：在生產環境部署 viduq3 API

測試完成後，下一步是將 viduq3 API 部署到您自己的應用、產品或內部環境。在真實的影片生成場景中，穩定存取與實際整合至關重要。

常見問題

定價

先參考上方的單次執行預估,再查看完整的 CometAPI 與官方價格比較。

5 秒測試

$0.28

預估 CometAPI 使用費用

10 秒測試

$0.56

預估 CometAPI 使用費用

15 秒測試

$0.84

預估 CometAPI 使用費用

Vidu Q3 的定價

Vidu Video Generation Pricing

Pricing (Per Second)

Model	360p	540p	720p	1080p
`viduq3`	$0.056	$0.056	$0.1232	$0.1232
`viduq3-turbo`	$0.028	$0.028	$0.0616	$0.0616

💡 Billed per second. Total cost = price per second × video duration (seconds).

API

複製可用的端點與程式碼範例,需要完整參數時再開啟完整 API 參考文件。

一個 API,直接對接正式環境模型

只需驗證一次,即可呼叫模型端點,並在各供應商間維持一致的計費與監控流程。

POST/v1/videos

Vidu Q3 的範例程式碼和 API

存取完整的範例程式碼和 API 資源，以簡化您的 Vidu Q3 整合流程。我們詳盡的文件提供逐步指引，協助您在專案中充分發揮 Vidu Q3 的潛力。

POST

/v1/videos

# Create a video with viduq3
# Step 1: Submit the video generation request
echo "Submitting video generation request..."
response=$(curl -s https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F "model=viduq3" \
  -F "prompt=Ultra-realistic cinematic shot of an astronaut walking slowly through soft fog, volumetric light in light blue and pale amber tones, shallow depth of field, 35mm film texture, graceful camera movement." \
  -F "seconds=1" \
  -F "size=960x528")

echo "Response: $response"

# Extract video_id from response (handle JSON with spaces like "id": "xxx")
video_id=$(echo "$response" | tr -d '
' | sed 's/.*"id"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/')
echo "Video ID: $video_id"

# Step 2: Poll for progress until 100%
echo ""
echo "Checking video generation progress..."
while true; do
  status_response=$(curl -s "https://api.cometapi.com/v1/videos/$video_id" \
    -H "Authorization: Bearer $COMETAPI_KEY")

  progress=$(echo "$status_response" | grep -o '"progress"[[:space:]]*:[[:space:]]*"\?[^",}]*"\?' | head -1 | sed 's/.*:[[:space:]]*"\?//;s/"$//')
  status=$(echo "$status_response" | grep -o '"status"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*"status"[[:space:]]*:[[:space:]]*"//;s/"$//')

  echo "Progress: $progress, Status: $status"

  if [ "$status" = "FAILURE" ] || [ "$status" = "failed" ] || [ "$status" = "error" ]; then
    echo "Video generation failed!"
    exit 1
  fi

  if [ "$progress" = "100%" ] || [ "$progress" = "100" ] || [ "$status" = "completed" ] || [ "$status" = "success" ]; then
    echo "Video generation completed!"
    break
  fi

  sleep 10
done

# Step 3: Download the video to output directory
echo ""
echo "Downloading video to ./output/$video_id.mp4..."
mkdir -p ./output
curl -s "https://api.cometapi.com/v1/videos/$video_id/content" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -o "./output/$video_id.mp4"

if [ -f "./output/$video_id.mp4" ]; then
  echo "Video saved to ./output/$video_id.mp4"
  ls -la "./output/$video_id.mp4"
else
  echo "Failed to download video"
  exit 1
fi

cURL Code Example

# Create a video with viduq3
# Step 1: Submit the video generation request
echo "Submitting video generation request..."
response=$(curl -s https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F "model=viduq3" \
  -F "prompt=Ultra-realistic cinematic shot of an astronaut walking slowly through soft fog, volumetric light in light blue and pale amber tones, shallow depth of field, 35mm film texture, graceful camera movement." \
  -F "seconds=1" \
  -F "size=960x528")

echo "Response: $response"

# Extract video_id from response (handle JSON with spaces like "id": "xxx")
video_id=$(echo "$response" | tr -d '\n' | sed 's/.*"id"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/')
echo "Video ID: $video_id"

# Step 2: Poll for progress until 100%
echo ""
echo "Checking video generation progress..."
while true; do
  status_response=$(curl -s "https://api.cometapi.com/v1/videos/$video_id" \
    -H "Authorization: Bearer $COMETAPI_KEY")
  
  progress=$(echo "$status_response" | grep -o '"progress"[[:space:]]*:[[:space:]]*"\?[^",}]*"\?' | head -1 | sed 's/.*:[[:space:]]*"\?//;s/"$//')
  status=$(echo "$status_response" | grep -o '"status"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*"status"[[:space:]]*:[[:space:]]*"//;s/"$//')
  
  echo "Progress: $progress, Status: $status"
  
  if [ "$status" = "FAILURE" ] || [ "$status" = "failed" ] || [ "$status" = "error" ]; then
    echo "Video generation failed!"
    exit 1
  fi
  
  if [ "$progress" = "100%" ] || [ "$progress" = "100" ] || [ "$status" = "completed" ] || [ "$status" = "success" ]; then
    echo "Video generation completed!"
    break
  fi
  
  sleep 10
done

# Step 3: Download the video to output directory
echo ""
echo "Downloading video to ./output/$video_id.mp4..."
mkdir -p ./output
curl -s "https://api.cometapi.com/v1/videos/$video_id/content" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -o "./output/$video_id.mp4"

if [ -f "./output/$video_id.mp4" ]; then
  echo "Video saved to ./output/$video_id.mp4"
  ls -la "./output/$video_id.mp4"
else
  echo "Failed to download video"
  exit 1
fi

Python Code Example

# Create a video with viduq3 using raw HTTP requests
import os
import time
import requests

api_key = os.environ.get("COMETAPI_KEY")
base_url = "https://api.cometapi.com/v1"
headers = {"Authorization": f"Bearer {api_key}"}

# Step 1: Submit the video generation request
print("Submitting video generation request...")
response = requests.post(
    f"{base_url}/videos",
    headers=headers,
    files={
        "model": (None, "viduq3"),
        "prompt": (None, "Ultra-realistic cinematic shot of an astronaut walking slowly through soft fog, volumetric light in light blue and pale amber tones, shallow depth of field, 35mm film texture, graceful camera movement."),
        "seconds": (None, "1"),
        "size": (None, "960x528"),
    },
)

result = response.json()
print(f"Response: {result}")

video_id = result.get("id") or result.get("task_id")
print(f"Video ID: {video_id}")

# Step 2: Poll for progress until 100%
print("\nChecking video generation progress...")
while True:
    try:
        status_response = requests.get(f"{base_url}/videos/{video_id}", headers=headers)
        status_result = status_response.json()

        data = status_result.get("data") or status_result
        progress = data.get("progress", "0%")
        status = data.get("status", "unknown")

        print(f"Progress: {progress}, Status: {status}")

        if status in ["FAILURE", "failed", "error"]:
            print("Video generation failed!")
            print(status_result)
            exit(1)

        if progress == "100%" or progress == 100 or status in ["completed", "success"]:
            print("Video generation completed!")
            break
    except Exception as e:
        print(f"Temporary error: {e}, retrying...")

    time.sleep(10)

# Step 3: Download the video to output directory
print(f"\nDownloading video to ./output/{video_id}.mp4...")
os.makedirs("./output", exist_ok=True)

video_response = requests.get(f"{base_url}/videos/{video_id}/content", headers=headers)

output_path = f"./output/{video_id}.mp4"
with open(output_path, "wb") as f:
    f.write(video_response.content)

if os.path.exists(output_path):
    file_size = os.path.getsize(output_path)
    print(f"Video saved to {output_path}")
    print(f"File size: {file_size} bytes")
else:
    print("Failed to download video")
    exit(1)

JavaScript Code Example

// Create a video with viduq3 using raw HTTP requests
import fs from "fs";
import path from "path";

const apiKey = process.env.COMETAPI_KEY;
const baseUrl = "https://api.cometapi.com/v1";
const headers = { Authorization: `Bearer ${apiKey}` };

function sleep(ms) {
  return new Promise((resolve) => setTimeout(resolve, ms));
}

// Step 1: Submit the video generation request
console.log("Submitting video generation request...");
const formData = new FormData();
formData.append("model", "viduq3");
formData.append("prompt", "Ultra-realistic cinematic shot of an astronaut walking slowly through soft fog, volumetric light in light blue and pale amber tones, shallow depth of field, 35mm film texture, graceful camera movement.");
formData.append("seconds", "1");
formData.append("size", "960x528");

const submitResponse = await fetch(`${baseUrl}/videos`, {
  method: "POST",
  headers,
  body: formData,
});

const result = await submitResponse.json();
console.log("Response:", JSON.stringify(result, null, 2));

const videoId = result.id || result.task_id;
console.log("Video ID:", videoId);

// Step 2: Poll for progress until 100%
console.log("\nChecking video generation progress...");
while (true) {
  try {
    const statusResponse = await fetch(`${baseUrl}/videos/${videoId}`, { headers });
    const statusResult = await statusResponse.json();
    const data = statusResult.data || statusResult;
    const progress = data.progress || "0%";
    const status = data.status || "unknown";

    console.log(`Progress: ${progress}, Status: ${status}`);

    if (status === "FAILURE" || status === "failed" || status === "error") {
      console.log("Video generation failed!");
      console.log(JSON.stringify(statusResult, null, 2));
      process.exit(1);
    }

    if (progress === "100%" || progress === 100 || status === "completed" || status === "success") {
      console.log("Video generation completed!");
      break;
    }
  } catch (e) {
    console.log(`Temporary error: ${e.message}, retrying...`);
  }

  await sleep(10000);
}

// Step 3: Download the video to output directory
console.log(`\nDownloading video to ./output/${videoId}.mp4...`);
fs.mkdirSync("./output", { recursive: true });

const videoResponse = await fetch(`${baseUrl}/videos/${videoId}/content`, { headers });
const outputPath = path.join("./output", `${videoId}.mp4`);
fs.writeFileSync(outputPath, Buffer.from(await videoResponse.arrayBuffer()));

if (fs.existsSync(outputPath)) {
  const stats = fs.statSync(outputPath);
  console.log(`Video saved to ${outputPath}`);
  console.log(`File size: ${stats.size} bytes`);
} else {
  console.log("Failed to download video");
  process.exit(1);
}