
Vidu Q3 Pro Start-End-to-Video API by Vidu
Vidu Q3-Pro Start-end-to-Video is an advanced AI video generation model that brings static images to life. Upload a reference image and describe the motion you want — the model generates high-quality video with smooth animation, optional audio, and cinematic quality up to 1080p.
INPUT
OUTPUT
MenungguPermintaan Anda akan dikenakan biaya $0.042 per eksekusi. Dengan $10 Anda dapat menjalankan model ini sekitar 238 kali.
Berikut yang dapat Anda lakukan selanjutnya:
Contoh kode
import requests
import time
# Step 1: Start video generation
generate_url = "https://api.atlascloud.ai/api/v1/model/generateVideo"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
"model": "vidu/q3-pro/start-end-to-video",
"prompt": "A beautiful sunset over the ocean with gentle waves",
"width": 512,
"height": 512,
"duration": 3,
"fps": 24,
}
generate_response = requests.post(generate_url, headers=headers, json=data)
generate_result = generate_response.json()
prediction_id = generate_result["data"]["id"]
# Step 2: Poll for result
poll_url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"
def check_status():
while True:
response = requests.get(poll_url, headers={"Authorization": "Bearer $ATLASCLOUD_API_KEY"})
result = response.json()
if result["data"]["status"] in ["completed", "succeeded"]:
print("Generated video:", result["data"]["outputs"][0])
return result["data"]["outputs"][0]
elif result["data"]["status"] == "failed":
raise Exception(result["data"]["error"] or "Generation failed")
else:
# Still processing, wait 2 seconds
time.sleep(2)
video_url = check_status()Instalasi
Instal paket yang diperlukan untuk bahasa pemrograman Anda.
pip install requestsAutentikasi
Semua permintaan API memerlukan autentikasi melalui API key. Anda bisa mendapatkan API key dari dasbor Atlas Cloud.
export ATLASCLOUD_API_KEY="your-api-key-here"HTTP Headers
import os
API_KEY = os.environ.get("ATLASCLOUD_API_KEY")
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {API_KEY}"
}Jangan pernah mengekspos API key Anda di kode sisi klien atau repositori publik. Gunakan variabel lingkungan atau proxy backend sebagai gantinya.
Kirim permintaan
import requests
url = "https://api.atlascloud.ai/api/v1/model/generateVideo"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
"model": "your-model",
"prompt": "A beautiful landscape"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())Kirim Permintaan
Kirim permintaan pembuatan asinkron. API mengembalikan prediction ID yang dapat Anda gunakan untuk memeriksa status dan mengambil hasil.
/api/v1/model/generateVideoIsi Permintaan
import requests
url = "https://api.atlascloud.ai/api/v1/model/generateVideo"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
"model": "vidu/q3-pro/start-end-to-video",
"input": {
"prompt": "A beautiful sunset over the ocean with gentle waves"
}
}
response = requests.post(url, headers=headers, json=data)
result = response.json()
print(f"Prediction ID: {result['id']}")
print(f"Status: {result['status']}")Respons
{
"id": "pred_abc123",
"status": "processing",
"model": "model-name",
"created_at": "2025-01-01T00:00:00Z"
}Periksa Status
Polling prediction endpoint untuk memeriksa status permintaan Anda saat ini.
/api/v1/model/prediction/{prediction_id}Contoh Polling
import requests
import time
prediction_id = "pred_abc123"
url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }
while True:
response = requests.get(url, headers=headers)
result = response.json()
status = result["data"]["status"]
print(f"Status: {status}")
if status in ["completed", "succeeded"]:
output_url = result["data"]["outputs"][0]
print(f"Output URL: {output_url}")
break
elif status == "failed":
print(f"Error: {result['data'].get('error', 'Unknown')}")
break
time.sleep(3)Nilai Status
processingPermintaan masih diproses.completedPembuatan selesai. Output tersedia.succeededPembuatan berhasil. Output tersedia.failedPembuatan gagal. Periksa field error.Respons Selesai
{
"data": {
"id": "pred_abc123",
"status": "completed",
"outputs": [
"https://storage.atlascloud.ai/outputs/result.mp4"
],
"metrics": {
"predict_time": 45.2
},
"created_at": "2025-01-01T00:00:00Z",
"completed_at": "2025-01-01T00:00:10Z"
}
}Unggah File
Unggah file ke penyimpanan Atlas Cloud dan dapatkan URL yang dapat Anda gunakan dalam permintaan API Anda. Gunakan multipart/form-data untuk mengunggah.
/api/v1/model/uploadMediaContoh Unggah
import requests
url = "https://api.atlascloud.ai/api/v1/model/uploadMedia"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }
with open("image.png", "rb") as f:
files = {"file": ("image.png", f, "image/png")}
response = requests.post(url, headers=headers, files=files)
result = response.json()
download_url = result["data"]["download_url"]
print(f"File URL: {download_url}")Respons
{
"data": {
"download_url": "https://storage.atlascloud.ai/uploads/abc123/image.png",
"file_name": "image.png",
"content_type": "image/png",
"size": 1024000
}
}Input Schema
Parameter berikut diterima di isi permintaan.
Tidak ada parameter yang tersedia.
Contoh Isi Permintaan
{
"model": "vidu/q3-pro/start-end-to-video"
}Output Schema
API mengembalikan respons prediction dengan URL output yang dihasilkan.
Contoh Respons
{
"id": "pred_abc123",
"status": "completed",
"model": "model-name",
"outputs": [
"https://storage.atlascloud.ai/outputs/result.mp4"
],
"metrics": {
"predict_time": 45.2
},
"created_at": "2025-01-01T00:00:00Z",
"completed_at": "2025-01-01T00:00:10Z"
}Atlas Cloud Skills
Atlas Cloud Skills mengintegrasikan 300+ model AI langsung ke asisten pengkodean AI Anda. Satu perintah untuk menginstal, lalu gunakan bahasa alami untuk menghasilkan gambar, video, dan mengobrol dengan LLM.
Klien yang Didukung
Instalasi
npx skills add AtlasCloudAI/atlas-cloud-skillsAtur API Key
Dapatkan API key dari dasbor Atlas Cloud dan atur sebagai variabel lingkungan.
export ATLASCLOUD_API_KEY="your-api-key-here"Kemampuan
Setelah diinstal, Anda dapat menggunakan bahasa alami di asisten AI Anda untuk mengakses semua model Atlas Cloud.
MCP Server
Atlas Cloud MCP Server menghubungkan IDE Anda dengan 300+ model AI melalui Model Context Protocol. Berfungsi dengan klien apa pun yang kompatibel dengan MCP.
Klien yang Didukung
Instalasi
npx -y atlascloud-mcpKonfigurasi
Tambahkan konfigurasi berikut ke file pengaturan MCP di IDE Anda.
{
"mcpServers": {
"atlascloud": {
"command": "npx",
"args": [
"-y",
"atlascloud-mcp"
],
"env": {
"ATLASCLOUD_API_KEY": "your-api-key-here"
}
}
}
}Alat yang Tersedia
Schema API
Schema tidak tersediaTidak ada contoh yang tersedia
Silakan masuk untuk melihat riwayat permintaan
Anda perlu masuk untuk mengakses riwayat permintaan model Anda.
MasukVidu Q3-Pro Start-End-to-Video
Vidu Q3-Pro Start-End-to-Video is an advanced AI video generation model that brings static images to life. Upload a reference image and describe the motion you want — the model generates high-quality video with smooth animation, optional audio, and cinematic quality up to 1080p.
Why Choose This?
-
Image-driven generation Transform any image into dynamic video with natural motion.
-
High resolution output Generate videos in 540p, 720p, or 1080p quality.
-
Flexible duration Create videos from 1 to 16 seconds in length.
-
Audio generation Optional synchronized audio and background music.
-
Motion control Adjust movement amplitude for subtle or dynamic animations.
-
Prompt Enhancer Built-in tool to automatically improve your motion descriptions.
Parameters
| Parameter | Required | Description |
|---|---|---|
| prompt | Yes | Text description of the desired motion and action |
| image | Yes | First frame of the video (URL or upload) |
| end_image | Yes | Last frame of the video (URL or upload) |
| resolution | No | Output quality: 540p, 720p (default), 1080p |
| duration | No | Video length in seconds (1-16, default: 5) |
| movement_amplitude | No | Motion intensity: auto (default), small, medium, large |
| generate_audio | No | Generate synchronized audio (default: enabled) |
| bgm | No | Add background music (default: enabled) |
| seed | No | Random seed for reproducibility |
How to Use
- Upload your image — provide the reference image to animate.
- Write your prompt — describe the motion, camera movement, and action.
- Set resolution — higher resolution for better quality, lower for faster processing.
- Adjust duration — set video length up to 16 seconds.
- Configure audio (optional) — enable/disable audio generation and background music.
- Set motion intensity (optional) — control how dynamic the movement is.
- Run — submit and download your video.
Pricing
| Resolution | Cost per second |
|---|---|
| 540p | $0.07 |
| 720p | $0.15 |
| 1080p | $0.16 |
Best Use Cases
- Photo Animation — Bring portraits, landscapes, and product images to life.
- Social Media Content — Create engaging video content from static images.
- Marketing & Ads — Generate dynamic promotional videos from product photos.
- Storytelling — Animate illustrations and artwork for narratives.
- Creative Projects — Explore motion concepts from reference images.
Pro Tips
- Use the Prompt Enhancer to refine your motion descriptions.
- Be specific about movement direction, speed, and camera angles.
- Set movement_amplitude to "small" for subtle, cinematic motion or "large" for dramatic action.
- Enable generate_audio for realistic sound effects matching the scene.
- Use high-quality source images for better video results.
- Describe environmental effects (wind, smoke, dust) for more immersive results.
Notes
- Both prompt and image are required fields.
- Maximum video duration is 16 seconds.
- Audio generation adds synchronized sound effects and ambient audio.
- BGM adds background music appropriate to the scene mood.
- Ensure uploaded image URLs are publicly accessible.
Related Models
- Vidu Q3-Pro Start-End-to-Video — Generate video directly from text descriptions.






