Documentazione API di Vidu Q3 Pro

Name: API Vidu Q3 Pro
Brand: Shengshu
SKU: shengshu/vidu-q3-pro
Availability: InStock

Tutto ciò che ti serve per chiamare Vidu Q3 Pro dal tuo codice. URL di base: https://cheapergen.com/api/v1. Provalo prima nel playground.

Usi un agente di programmazione?

Incolla questo testo in Claude Code, Cursor, Codex o qualsiasi agente di programmazione. Aggiunge l’API al tuo progetto, conserva la chiave in CHEAPERGEN_API_KEY ed esegue una prova con un preventivo gratuito prima di spendere.

Add Vidu Q3 Pro (CheaperGen endpoint shengshu/vidu-q3-pro/text-to-video) to this project by following https://cheapergen.com/agents/integrate.md

Cosa legge il tuo agente

Autenticazione

Crea una chiave in Dashboard → Chiavi API, inviala come token bearer e conservala lato server.

export CHEAPERGEN_API_KEY="cg_live_…"

# every request
Authorization: Bearer $CHEAPERGEN_API_KEY

API Vidu Q3 Pro Da testo a video

POST/api/v1/run/shengshu/vidu-q3-pro/text-to-video

Invia un job asincrono e restituisce 202 con l’ID della generazione. Interroga GET /api/v1/generations/{id} o specifica webhook_url. Consulta il ciclo di vita dei job.

Parametri di input

Nome	Tipo	Descrizione	Effetto sul prezzo
`prompt`obbligatorio	string	Descrivi l’inquadratura: soggetto, azione, movimento della camera, illuminazione e stile.	No
`aspect_ratio`	string (enum)	Formato del fotogramma in output. Valori: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 Predefinito: 16:9	Sì
`resolution`	string (enum)	Risoluzione dell’output. Le risoluzioni più alte costano di più al secondo. Valori: 540p · 720p · 1080p Predefinito: 720p	Sì
`duration`	integer	Durata della clip generata in secondi (1–16 s). Paghi al secondo. Intervallo: 1–16s Predefinito: 5	Sì
`generate_audio`	boolean	Genera dialoghi ed effetti sonori sincronizzati. Inclusi nel prezzo. Predefinito: true	No
`seed`	integer	Usa lo stesso seed e le stesse impostazioni per riprodurre un risultato. Lascia vuoto per un valore casuale.	No
`webhook_url`	stringa (URL)	Facoltativo. Inviamo con POST la generazione completata a questo indirizzo, firmandola con il segreto del webhook. Webhook	No

Richiesta

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/shengshu/vidu-q3-pro/text-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "Un guardiano del faro sale la scala a chiocciola durante una tempesta, i lampi attraversano le finestre e il fascio di luce spazia sulle onde; poi la scena passa alla sala della lanterna mentre lei la accende",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.video.url : job.error);

import os, time, requests

API = "https://cheapergen.com/api/v1"
headers = {"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"}

# 1. Submit the job
job = requests.post(f"{API}/run/shengshu/vidu-q3-pro/text-to-video", headers=headers, json={
    "prompt": "Un guardiano del faro sale la scala a chiocciola durante una tempesta, i lampi attraversano le finestre e il fascio di luce spazia sulle onde; poi la scena passa alla sala della lanterna mentre lei la accende",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
}).json()

# 2. Poll until it finishes (or pass "webhook_url" and skip polling)
while job["status"] in ("queued", "running"):
    time.sleep(3)
    job = requests.get(f"{API}/generations/{job['id']}", headers=headers).json()

print(job["status"], job["output"]["video"]["url"] if job["status"] == "succeeded" else job["error"])

curl -X POST https://cheapergen.com/api/v1/run/shengshu/vidu-q3-pro/text-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Un guardiano del faro sale la scala a chiocciola durante una tempesta, i lampi attraversano le finestre e il fascio di luce spazia sulle onde; poi la scena passa alla sala della lanterna mentre lei la accende",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'

Risposta

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "shengshu/vidu-q3-pro",
  "endpoint": "shengshu/vidu-q3-pro/text-to-video",
  "mode": "text-to-video",
  "status": "queued",
  "input": {
    "prompt": "Un guardiano del faro sale la scala a chiocciola durante una tempesta, i lampi attraversano le finestre e il fascio di luce spazia sulle onde; poi la scena passa alla sala della lanterna mentre lei la accende",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "shengshu/vidu-q3-pro",
  "endpoint": "shengshu/vidu-q3-pro/text-to-video",
  "mode": "text-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "Un guardiano del faro sale la scala a chiocciola durante una tempesta, i lampi attraversano le finestre e il fascio di luce spazia sulle onde; poi la scena passa alla sala della lanterna mentre lei la accende",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4",
      "duration": 5,
      "width": 1280,
      "height": 720
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}

API Vidu Q3 Pro Da immagine a video

POST/api/v1/run/shengshu/vidu-q3-pro/image-to-video

Invia un job asincrono e restituisce 202 con l’ID della generazione. Interroga GET /api/v1/generations/{id} o specifica webhook_url. Consulta il ciclo di vita dei job.

Parametri di input

Nome	Tipo	Descrizione	Effetto sul prezzo
`prompt`obbligatorio	string	Descrivi l’inquadratura: soggetto, azione, movimento della camera, illuminazione e stile.	No
`image_url`obbligatorio	string (URL)	Immagine usata come fotogramma iniziale. JPG/PNG/WebP, URL o caricamento.	No
`end_image_url`	string (URL)	Fotogramma conclusivo facoltativo: il modello anima la transizione tra i due.	No
`resolution`	string (enum)	Risoluzione dell’output. Le risoluzioni più alte costano di più al secondo. Valori: 540p · 720p · 1080p Predefinito: 720p	Sì
`duration`	integer	Durata della clip generata in secondi (1–16 s). Paghi al secondo. Intervallo: 1–16s Predefinito: 5	Sì
`generate_audio`	boolean	Genera dialoghi ed effetti sonori sincronizzati. Inclusi nel prezzo. Predefinito: true	No
`seed`	integer	Usa lo stesso seed e le stesse impostazioni per riprodurre un risultato. Lascia vuoto per un valore casuale.	No
`webhook_url`	stringa (URL)	Facoltativo. Inviamo con POST la generazione completata a questo indirizzo, firmandola con il segreto del webhook. Webhook	No

Richiesta

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/shengshu/vidu-q3-pro/image-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "La ballerina gira una volta e si immobilizza in posa mentre le luci del palco si accendono; lento avvicinamento della camera, gli applausi crescono",
    "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
    "resolution": "720p",
    "duration": 5
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.video.url : job.error);

import os, time, requests

API = "https://cheapergen.com/api/v1"
headers = {"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"}

# 1. Submit the job
job = requests.post(f"{API}/run/shengshu/vidu-q3-pro/image-to-video", headers=headers, json={
    "prompt": "La ballerina gira una volta e si immobilizza in posa mentre le luci del palco si accendono; lento avvicinamento della camera, gli applausi crescono",
    "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
    "resolution": "720p",
    "duration": 5
}).json()

# 2. Poll until it finishes (or pass "webhook_url" and skip polling)
while job["status"] in ("queued", "running"):
    time.sleep(3)
    job = requests.get(f"{API}/generations/{job['id']}", headers=headers).json()

print(job["status"], job["output"]["video"]["url"] if job["status"] == "succeeded" else job["error"])

curl -X POST https://cheapergen.com/api/v1/run/shengshu/vidu-q3-pro/image-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "La ballerina gira una volta e si immobilizza in posa mentre le luci del palco si accendono; lento avvicinamento della camera, gli applausi crescono",
  "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
  "resolution": "720p",
  "duration": 5
}'

Risposta

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "shengshu/vidu-q3-pro",
  "endpoint": "shengshu/vidu-q3-pro/image-to-video",
  "mode": "image-to-video",
  "status": "queued",
  "input": {
    "prompt": "La ballerina gira una volta e si immobilizza in posa mentre le luci del palco si accendono; lento avvicinamento della camera, gli applausi crescono",
    "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
    "resolution": "720p",
    "duration": 5
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "shengshu/vidu-q3-pro",
  "endpoint": "shengshu/vidu-q3-pro/image-to-video",
  "mode": "image-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "La ballerina gira una volta e si immobilizza in posa mentre le luci del palco si accendono; lento avvicinamento della camera, gli applausi crescono",
    "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
    "resolution": "720p",
    "duration": 5
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4",
      "duration": 5,
      "width": 1280,
      "height": 720
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}

Ottieni il risultato

Le generazioni sono asincrone. Continua a interrogare finché il campo status non vale succeeded, failed o canceled; oppure specifica webhook_url al momento dell’invio. Le generazioni non riuscite vengono rimborsate automaticamente.

curl https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4 \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY"

Altro: ciclo di vita dei job · i webhook · errori

prezzi di Vidu Q3 Pro

Paga al secondo di video man mano che le usi, senza abbonamento (piani mensili sono facoltativi). Le generazioni non riuscite vengono rimborsate automaticamente.

Fascia	Prezzo ufficiale	CheaperGen	Risparmi
540p audio incluso	~~$0,045~~/s	$0,0337/s	−25%
720p audio incluso	~~$0,10~~/s	$0,0748/s	−25%
1080p audio incluso	~~$0,12~~/s	$0,0897/s	−25%

Prezzo ufficiale: Prezzo di listino dell’API internazionale Vidu per viduq3-pro (da testo / immagine / primo e ultimo fotogramma a video), platform.vidu.com/pricing, $0.005 per credito, verificato il 2026-10-19 (540p 9 crediti = $0.045 / s, 720p 20 = $0.10, 1080p 24 = $0.12; audio incluso). Prezzi verificati il 18 ottobre 2026.