From adf2297f9c86c43d762fc25b4ff142401496e921 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Fri, 17 Jul 2026 12:10:04 +0000
Subject: [PATCH 1/2] docs: clarify API vs consumer plans and video quote
parameter scope
---
guides/media/video-generation.mdx | 14 ++++++++++++++
overview/pricing.mdx | 6 ++++++
2 files changed, 20 insertions(+)
diff --git a/guides/media/video-generation.mdx b/guides/media/video-generation.mdx
index a78a34f0..107cb219 100644
--- a/guides/media/video-generation.mdx
+++ b/guides/media/video-generation.mdx
@@ -339,6 +339,20 @@ Get exact cost before generating. Send only pricing inputs (`model`, `duration`,
Quote is in USD.
+
+**Quote parameters are pricing inputs only.** Fields you send to `/video/quote` — including `aspect_ratio`, `audio`, and `reference_video_total_duration` — are used purely to compute the price. They are **not** forwarded to `/video/queue` and do not affect the generated video. Sending `aspect_ratio` to quote is accepted even for models (such as `seedance-2-0-image-to-video`) that reject `aspect_ratio` at generation time, since image-to-video models derive the output aspect ratio from the input image.
+
+
+### Reference-to-video pricing
+
+For R2V models (e.g. Seedance 2.0 R2V), pass `reference_video_total_duration` — the aggregate duration in seconds of all reference clips you plan to include — so the quote reflects the "input with video" rate tier and the `(input + output) × pixels` token formula. Omit it and the quote returns the no-reference baseline instead.
+
+`reference_video_total_duration` is only recognized by `/video/quote`. It has no effect on `/video/queue` and omitting it will not cause a generation error.
+
+### Displaying stable prices
+
+Quotes are point-in-time and prices can change. If you want to show a fixed price in your app, call `/video/quote` once for each parameter combination you support and cache the result in your own store — then re-quote on a schedule (or on price-list updates) to refresh the cached value. There is no "locked" or "static" quote endpoint.
+
---
## Errors
diff --git a/overview/pricing.mdx b/overview/pricing.mdx
index 65be022b..b0370674 100644
--- a/overview/pricing.mdx
+++ b/overview/pricing.mdx
@@ -6,6 +6,10 @@ title: API Pricing
Prices per 1M tokens unless noted. All prices in USD. 1 Diem = $1/day of compute.
+
+**API vs. consumer plans.** The Venice API is billed **pay-per-use** in USD credits (or via staked DIEM). It is separate from the Venice consumer web app's monthly subscription plans (Free, Pro, Max), whose allowances — such as image counts or unlimited chat — apply only to the web/desktop/mobile apps, **not** to API usage. All API calls are metered against your API credit balance regardless of your consumer plan. See [Pro Users](#pro-users) below for the one-time credit Pro subscribers receive.
+
+
## Text Models
### Chat Completions
@@ -428,3 +432,5 @@ These charges apply in addition to standard model token pricing.
### Pro Users
Pro subscribers receive a one-time $10 API credit when upgrading to Pro. Use it to test and build small apps.
+
+Beyond that credit, API usage is billed the same pay-per-use rates listed above — the Pro subscription itself does not include additional API allowances such as included images, characters, or tokens. Some models are gated to Pro accounts (`PRO_ONLY_MODEL`); calling them from an account without an active Pro subscription returns `AUTHENTICATION_FAILED_INACTIVE_KEY`. See [Error Codes](/api-reference/error-codes).
From 820f5650ab54a6a5039805f93243ce2b9dc3d167 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Fri, 17 Jul 2026 12:16:59 +0000
Subject: [PATCH 2/2] docs: mirror pricing and video quote clarifications to 8
target languages and tighten SEO descriptions
---
ar/guides/media/video-generation.mdx | 14 ++++++++++++++
ar/overview/pricing.mdx | 6 ++++++
de/guides/media/video-generation.mdx | 14 ++++++++++++++
de/overview/pricing.mdx | 6 ++++++
es/guides/media/video-generation.mdx | 14 ++++++++++++++
es/overview/pricing.mdx | 6 ++++++
fr/guides/media/video-generation.mdx | 14 ++++++++++++++
fr/overview/pricing.mdx | 6 ++++++
guides/media/video-generation.mdx | 2 +-
it/guides/media/video-generation.mdx | 14 ++++++++++++++
it/overview/pricing.mdx | 6 ++++++
ko/guides/media/video-generation.mdx | 14 ++++++++++++++
ko/overview/pricing.mdx | 6 ++++++
overview/pricing.mdx | 1 +
pt-BR/guides/media/video-generation.mdx | 14 ++++++++++++++
pt-BR/overview/pricing.mdx | 6 ++++++
zh/guides/media/video-generation.mdx | 14 ++++++++++++++
zh/overview/pricing.mdx | 6 ++++++
18 files changed, 162 insertions(+), 1 deletion(-)
diff --git a/ar/guides/media/video-generation.mdx b/ar/guides/media/video-generation.mdx
index 0ea86339..3b201b36 100644
--- a/ar/guides/media/video-generation.mdx
+++ b/ar/guides/media/video-generation.mdx
@@ -339,6 +339,20 @@ await fetch(`${BASE_URL}/video/complete`, {
عرض السعر بالدولار الأمريكي.
+
+**معاملات عرض السعر هي مدخلات تسعير فقط.** الحقول التي ترسلها إلى `/video/quote` — بما في ذلك `aspect_ratio` و`audio` و`reference_video_total_duration` — تُستخدم بحتًا لحساب السعر. **لا** تُمرَّر إلى `/video/queue` ولا تؤثر في الفيديو المولَّد. يُقبل إرسال `aspect_ratio` إلى quote حتى بالنسبة للنماذج (مثل `seedance-2-0-image-to-video`) التي ترفض `aspect_ratio` وقت التوليد، لأن نماذج الصورة إلى فيديو تشتق نسبة العرض إلى الارتفاع للإخراج من صورة الإدخال.
+
+
+### تسعير المرجع إلى فيديو
+
+بالنسبة لنماذج R2V (مثل Seedance 2.0 R2V)، مرّر `reference_video_total_duration` — وهي المدة الإجمالية بالثواني لجميع المقاطع المرجعية التي تعتزم تضمينها — كي يعكس عرض السعر فئة سعر "إدخال مع فيديو" وصيغة الرموز `(الإدخال + الإخراج) × البكسلات`. إن أغفلته، فإن عرض السعر يعيد الحد الأساسي بلا مرجع بدلًا من ذلك.
+
+`reference_video_total_duration` مُعترف به فقط بواسطة `/video/quote`. ليس له أي تأثير على `/video/queue`، وإغفاله لن يتسبب في خطأ توليد.
+
+### عرض أسعار ثابتة
+
+عروض الأسعار لحظية وقد تتغير الأسعار. إن أردت عرض سعر ثابت في تطبيقك، فاستدعِ `/video/quote` مرة واحدة لكل مجموعة من المعاملات التي تدعمها واحفظ النتيجة في مخزنك الخاص — ثم أعد طلب عرض السعر وفق جدول زمني (أو عند تحديثات قائمة الأسعار) لتحديث القيمة المخزنة. لا توجد نقطة نهاية لعرض سعر "مقفل" أو "ثابت".
+
---
## الأخطاء
diff --git a/ar/overview/pricing.mdx b/ar/overview/pricing.mdx
index 0b8b2956..7071babe 100644
--- a/ar/overview/pricing.mdx
+++ b/ar/overview/pricing.mdx
@@ -7,6 +7,10 @@ description: "أسعار Venice API لكل مليون رمز لنماذج الن
الأسعار لكل مليون رمز (token) ما لم يُذكر خلاف ذلك. جميع الأسعار بالدولار الأمريكي. 1 Diem = 1$ يوميًا من الحوسبة.
+
+**خطط الـ API مقابل خطط المستهلك.** تُحاسَب Venice API **حسب الاستخدام** بأرصدة بالدولار الأمريكي (أو عبر DIEM المرهون). وهي منفصلة عن خطط الاشتراك الشهرية لتطبيق Venice للمستهلك على الويب (Free وPro وMax)، والتي تنطبق مخصصاتها — مثل عدد الصور أو الدردشة غير المحدودة — على تطبيقات الويب/سطح المكتب/الجوال فقط، **وليس** على استخدام الـ API. تُحتسب جميع استدعاءات الـ API من رصيد اعتمادات الـ API الخاص بك بصرف النظر عن خطتك كمستهلك. راجع [مستخدمو Pro](#مستخدمو-pro) أدناه للاطلاع على الرصيد لمرة واحدة الذي يحصل عليه مشتركو Pro.
+
+
## نماذج النص
### Chat Completions
@@ -435,3 +439,5 @@ description: "أسعار Venice API لكل مليون رمز لنماذج الن
### مستخدمو Pro
يحصل مشتركو Pro على رصيد API لمرة واحدة بقيمة 10$ عند الترقية إلى Pro. استخدمه لاختبار وبناء تطبيقات صغيرة.
+
+وبعد هذا الرصيد، يُحاسَب استخدام الـ API بنفس أسعار الدفع حسب الاستخدام المذكورة أعلاه — لا يشمل اشتراك Pro نفسه أي مخصصات إضافية للـ API مثل صور أو أحرف أو رموز مضمّنة. تقتصر بعض النماذج على حسابات Pro (`PRO_ONLY_MODEL`)؛ ويؤدي استدعاؤها من حساب بلا اشتراك Pro فعّال إلى إعادة `AUTHENTICATION_FAILED_INACTIVE_KEY`. راجع [رموز الأخطاء](/api-reference/error-codes).
diff --git a/de/guides/media/video-generation.mdx b/de/guides/media/video-generation.mdx
index e94bf19b..efe09c24 100644
--- a/de/guides/media/video-generation.mdx
+++ b/de/guides/media/video-generation.mdx
@@ -339,6 +339,20 @@ Exakte Kosten vor der Generierung. Nur die Pricing-Inputs senden (`model`, `dura
Das Quote ist in USD.
+
+**Quote-Parameter sind ausschließlich Preis-Inputs.** Felder, die Sie an `/video/quote` senden – darunter `aspect_ratio`, `audio` und `reference_video_total_duration` – dienen ausschließlich der Preisberechnung. Sie werden **nicht** an `/video/queue` weitergeleitet und haben keinen Einfluss auf das generierte Video. `aspect_ratio` an Quote zu senden ist auch bei Modellen zulässig (z. B. `seedance-2-0-image-to-video`), die `aspect_ratio` bei der Generierung ablehnen, da Image-to-Video-Modelle das Ausgabe-Seitenverhältnis aus dem Eingabebild ableiten.
+
+
+### Preisberechnung bei Reference-to-Video
+
+Bei R2V-Modellen (z. B. Seedance 2.0 R2V) übergeben Sie `reference_video_total_duration` – die Gesamtdauer in Sekunden aller Referenz-Clips, die Sie einbinden möchten –, damit das Quote die Preisstufe „Input mit Video" und die Token-Formel `(input + output) × pixels` widerspiegelt. Lassen Sie den Wert weg, gibt das Quote stattdessen den Basiswert ohne Referenz zurück.
+
+`reference_video_total_duration` wird ausschließlich von `/video/quote` erkannt. Es hat keine Auswirkung auf `/video/queue`, und ein Weglassen führt nicht zu einem Generierungsfehler.
+
+### Stabile Preise anzeigen
+
+Quotes sind zeitpunktbezogen und Preise können sich ändern. Wenn Sie in Ihrer App einen festen Preis anzeigen möchten, rufen Sie `/video/quote` einmal für jede von Ihnen unterstützte Parameterkombination auf und cachen Sie das Ergebnis in Ihrem eigenen Speicher – aktualisieren Sie den gecachten Wert dann nach einem Zeitplan (oder bei Preislisten-Aktualisierungen) durch erneutes Quoten. Es gibt keinen Endpoint für „gesperrte" oder „statische" Quotes.
+
---
## Fehler
diff --git a/de/overview/pricing.mdx b/de/overview/pricing.mdx
index 286f52fc..bfb72412 100644
--- a/de/overview/pricing.mdx
+++ b/de/overview/pricing.mdx
@@ -7,6 +7,10 @@ description: "Preise der Venice API pro 1M Tokens für Text-, Bild-, Video-, Aud
Preise pro 1M Tokens, sofern nicht anders angegeben. Alle Preise in USD. 1 Diem = $1/Tag Rechenleistung.
+
+**API- vs. Consumer-Pläne.** Die Venice API wird **nutzungsbasiert (pay-per-use)** in USD-Credits (oder über gestaktes DIEM) abgerechnet. Sie ist getrennt von den monatlichen Abo-Plänen (Free, Pro, Max) der Venice Consumer-Web-App, deren Kontingente – etwa Bildanzahlen oder unbegrenzter Chat – ausschließlich für die Web-/Desktop-/Mobile-Apps gelten, **nicht** für die API-Nutzung. Alle API-Aufrufe werden unabhängig von Ihrem Consumer-Plan gegen Ihr API-Credit-Guthaben abgerechnet. Siehe [Pro-Nutzer](#pro-nutzer) unten für das einmalige Credit-Guthaben, das Pro-Abonnenten erhalten.
+
+
## Textmodelle
### Chat Completions
@@ -435,3 +439,5 @@ Diese Gebühren fallen zusätzlich zu den Standard-Modell-Token-Preisen an.
### Pro-Nutzer
Pro-Abonnenten erhalten beim Upgrade auf Pro einmalig 10 USD an API-Credits. Verwenden Sie diese, um zu testen und kleine Apps zu entwickeln.
+
+Darüber hinaus wird die API-Nutzung zu denselben nutzungsbasierten Tarifen abgerechnet, die oben aufgeführt sind – das Pro-Abonnement selbst enthält keine zusätzlichen API-Kontingente wie inkludierte Bilder, Zeichen oder Tokens. Einige Modelle sind auf Pro-Konten beschränkt (`PRO_ONLY_MODEL`); ein Aufruf von einem Konto ohne aktives Pro-Abonnement gibt `AUTHENTICATION_FAILED_INACTIVE_KEY` zurück. Siehe [Fehlercodes](/api-reference/error-codes).
diff --git a/es/guides/media/video-generation.mdx b/es/guides/media/video-generation.mdx
index 66c9c7c7..ff7ba51e 100644
--- a/es/guides/media/video-generation.mdx
+++ b/es/guides/media/video-generation.mdx
@@ -339,6 +339,20 @@ Obtén el coste exacto antes de generar. Envía solo entradas de precio (`model`
La cotización es en USD.
+
+**Los parámetros de cotización son solo entradas de precio.** Los campos que envías a `/video/quote` —incluyendo `aspect_ratio`, `audio` y `reference_video_total_duration`— se usan únicamente para calcular el precio. **No** se reenvían a `/video/queue` y no afectan al vídeo generado. Enviar `aspect_ratio` a quote se acepta incluso para modelos (como `seedance-2-0-image-to-video`) que rechazan `aspect_ratio` en el momento de la generación, ya que los modelos image-to-video derivan la relación de aspecto de salida a partir de la imagen de entrada.
+
+
+### Precios de reference-to-video
+
+Para los modelos R2V (p. ej., Seedance 2.0 R2V), pasa `reference_video_total_duration` —la duración agregada en segundos de todos los clips de referencia que planeas incluir— para que la cotización refleje el nivel de tarifa "input with video" y la fórmula de tokens `(input + output) × pixels`. Omítelo y la cotización devolverá la línea base sin referencia.
+
+`reference_video_total_duration` solo es reconocido por `/video/quote`. No tiene efecto en `/video/queue` y omitirlo no provocará un error de generación.
+
+### Mostrar precios estables
+
+Las cotizaciones son puntuales en el tiempo y los precios pueden cambiar. Si quieres mostrar un precio fijo en tu app, llama a `/video/quote` una vez para cada combinación de parámetros que admitas y almacena el resultado en tu propio store; luego vuelve a cotizar de forma programada (o cuando se actualicen las listas de precios) para refrescar el valor en caché. No existe un endpoint de cotización "bloqueada" o "estática".
+
---
## Errores
diff --git a/es/overview/pricing.mdx b/es/overview/pricing.mdx
index 6428a189..f88255de 100644
--- a/es/overview/pricing.mdx
+++ b/es/overview/pricing.mdx
@@ -7,6 +7,10 @@ description: "Precios de la API de Venice por 1M de tokens para modelos de texto
Precios por 1M de tokens salvo que se indique lo contrario. Todos los precios en USD. 1 Diem = $1/día de cómputo.
+
+**Planes de API vs. planes de consumidor.** La API de Venice se factura **por uso** en créditos USD (o mediante DIEM en staking). Es independiente de los planes de suscripción mensual de la app web de consumidor de Venice (Free, Pro, Max), cuyas asignaciones —como recuentos de imágenes o chat ilimitado— se aplican únicamente a las apps web/escritorio/móvil, **no** al uso de la API. Todas las llamadas a la API se contabilizan contra el saldo de créditos de tu API independientemente de tu plan de consumidor. Consulta [Usuarios Pro](#usuarios-pro) más abajo para el crédito único que reciben los suscriptores Pro.
+
+
## Modelos de texto
### Chat Completions
@@ -435,3 +439,5 @@ Estos cargos se aplican además del precio estándar de tokens del modelo.
### Usuarios Pro
Los suscriptores Pro reciben un crédito único de $10 para la API al actualizarse a Pro. Úsalo para probar y construir aplicaciones pequeñas.
+
+Más allá de ese crédito, el uso de la API se factura a las mismas tarifas de pago por uso indicadas arriba: la suscripción Pro en sí no incluye asignaciones adicionales de API como imágenes, caracteres o tokens incluidos. Algunos modelos están restringidos a cuentas Pro (`PRO_ONLY_MODEL`); llamarlos desde una cuenta sin una suscripción Pro activa devuelve `AUTHENTICATION_FAILED_INACTIVE_KEY`. Consulta [Códigos de error](/api-reference/error-codes).
diff --git a/fr/guides/media/video-generation.mdx b/fr/guides/media/video-generation.mdx
index 544799e1..77d6924f 100644
--- a/fr/guides/media/video-generation.mdx
+++ b/fr/guides/media/video-generation.mdx
@@ -339,6 +339,20 @@ Obtenez le coût exact avant la génération. Envoyez uniquement les entrées de
Le devis est en USD.
+
+**Les paramètres du devis servent uniquement au calcul du prix.** Les champs que vous envoyez à `/video/quote` — y compris `aspect_ratio`, `audio` et `reference_video_total_duration` — sont utilisés uniquement pour calculer le prix. Ils **ne sont pas** transmis à `/video/queue` et n'influencent pas la vidéo générée. Envoyer `aspect_ratio` au quote est accepté même pour les modèles (tels que `seedance-2-0-image-to-video`) qui rejettent `aspect_ratio` au moment de la génération, puisque les modèles image-to-video dérivent le ratio d'aspect de sortie à partir de l'image d'entrée.
+
+
+### Tarification reference-to-video
+
+Pour les modèles R2V (par exemple Seedance 2.0 R2V), transmettez `reference_video_total_duration` — la durée cumulée en secondes de tous les clips de référence que vous prévoyez d'inclure — afin que le devis reflète le palier de tarif « input with video » et la formule de tokens `(input + output) × pixels`. Omettez-le et le devis renverra plutôt la valeur de base sans référence.
+
+`reference_video_total_duration` n'est reconnu que par `/video/quote`. Il n'a aucun effet sur `/video/queue` et l'omettre ne provoquera pas d'erreur de génération.
+
+### Afficher des prix stables
+
+Les devis sont ponctuels et les prix peuvent changer. Si vous souhaitez afficher un prix fixe dans votre application, appelez `/video/quote` une fois pour chaque combinaison de paramètres que vous prenez en charge et mettez le résultat en cache dans votre propre stockage — puis redemandez un devis selon une planification (ou lors des mises à jour de la liste de prix) pour rafraîchir la valeur en cache. Il n'existe pas d'endpoint de devis « verrouillé » ou « statique ».
+
---
## Erreurs
diff --git a/fr/overview/pricing.mdx b/fr/overview/pricing.mdx
index 5d3390dd..6fd7d19e 100644
--- a/fr/overview/pricing.mdx
+++ b/fr/overview/pricing.mdx
@@ -7,6 +7,10 @@ description: "Tarifs de l'API Venice par million de tokens pour les modèles tex
Prix par 1M de tokens sauf indication contraire. Tous les prix en USD. 1 Diem = 1 $/jour de compute.
+
+**API vs. plans consommateurs.** L'API Venice est facturée **à l'usage** en crédits USD (ou via des DIEM stakés). Elle est distincte des abonnements mensuels de l'application web consommateur de Venice (Free, Pro, Max), dont les quotas — comme les nombres d'images ou le chat illimité — s'appliquent uniquement aux applications web/desktop/mobile, **et non** à l'utilisation de l'API. Tous les appels API sont décomptés de votre solde de crédits API, quel que soit votre plan consommateur. Voir [Utilisateurs Pro](#utilisateurs-pro) ci-dessous pour le crédit unique dont bénéficient les abonnés Pro.
+
+
## Modèles de texte
### Chat Completions
@@ -435,3 +439,5 @@ Ces frais s'appliquent en plus de la tarification standard des tokens du modèle
### Utilisateurs Pro
Les abonnés Pro reçoivent un crédit API unique de $10 lors du passage à Pro. Utilisez-le pour tester et créer de petites applications.
+
+Au-delà de ce crédit, l'utilisation de l'API est facturée aux mêmes tarifs à l'usage indiqués ci-dessus — l'abonnement Pro en lui-même n'inclut pas de quotas API supplémentaires tels que des images, caractères ou tokens inclus. Certains modèles sont réservés aux comptes Pro (`PRO_ONLY_MODEL`) ; les appeler depuis un compte sans abonnement Pro actif renvoie `AUTHENTICATION_FAILED_INACTIVE_KEY`. Voir [Codes d'erreur](/api-reference/error-codes).
diff --git a/guides/media/video-generation.mdx b/guides/media/video-generation.mdx
index 107cb219..16a944c0 100644
--- a/guides/media/video-generation.mdx
+++ b/guides/media/video-generation.mdx
@@ -1,6 +1,6 @@
---
title: Video Generation
-description: Generate videos from text prompts or starting images on Venice's asynchronous queue API — submit a job, poll for status, and download the finished video.
+description: Generate videos from text prompts or images on Venice's async queue API — submit a job, poll for status, and download the finished video.
"og:title": "Video Generation | Venice API Docs"
"og:description": "Learn how to generate videos from text prompts or images using Venice's async video generation API."
---
diff --git a/it/guides/media/video-generation.mdx b/it/guides/media/video-generation.mdx
index 903d9d6f..fd2a60bd 100644
--- a/it/guides/media/video-generation.mdx
+++ b/it/guides/media/video-generation.mdx
@@ -339,6 +339,20 @@ Ottieni il costo esatto prima di generare. Invia solo gli input di pricing (`mod
Il preventivo è in USD.
+
+**I parametri della quote sono solo input di pricing.** I campi che invii a `/video/quote` — inclusi `aspect_ratio`, `audio` e `reference_video_total_duration` — vengono usati esclusivamente per calcolare il prezzo. **Non** vengono inoltrati a `/video/queue` e non influenzano il video generato. Inviare `aspect_ratio` alla quote è accettato anche per i modelli (come `seedance-2-0-image-to-video`) che rifiutano `aspect_ratio` al momento della generazione, poiché i modelli image-to-video ricavano l'aspect ratio di output dall'immagine di input.
+
+
+### Prezzi reference-to-video
+
+Per i modelli R2V (per esempio Seedance 2.0 R2V), passa `reference_video_total_duration` — la durata aggregata in secondi di tutti i clip di riferimento che intendi includere — così la quote riflette la fascia tariffaria "input with video" e la formula token `(input + output) × pixel`. Se lo ometti, la quote restituisce invece il valore di base senza riferimento.
+
+`reference_video_total_duration` è riconosciuto solo da `/video/quote`. Non ha effetto su `/video/queue` e ometterlo non causerà un errore di generazione.
+
+### Mostrare prezzi stabili
+
+Le quote sono valide in un dato momento e i prezzi possono cambiare. Se vuoi mostrare un prezzo fisso nella tua app, chiama `/video/quote` una volta per ogni combinazione di parametri che supporti e memorizza il risultato nel tuo store — poi riquota su base pianificata (o agli aggiornamenti del listino) per aggiornare il valore in cache. Non esiste un endpoint di quote "bloccato" o "statico".
+
---
## Errori
diff --git a/it/overview/pricing.mdx b/it/overview/pricing.mdx
index 95c2bd99..272de4a3 100644
--- a/it/overview/pricing.mdx
+++ b/it/overview/pricing.mdx
@@ -7,6 +7,10 @@ description: "Prezzi dell'API Venice per 1M di token su modelli di testo, immagi
Prezzi per 1M di token salvo diversa indicazione. Tutti i prezzi sono in USD. 1 Diem = $1/giorno di compute.
+
+**API vs. piani consumer.** L'API Venice è fatturata **a consumo (pay-per-use)** in crediti USD (o tramite DIEM in staking). È separata dai piani di abbonamento mensili dell'app web consumer di Venice (Free, Pro, Max), le cui quote — come il numero di immagini o la chat illimitata — si applicano soltanto alle app web/desktop/mobile, **non** all'uso dell'API. Tutte le chiamate API vengono contabilizzate sul saldo dei crediti API indipendentemente dal tuo piano consumer. Vedi [Utenti Pro](#utenti-pro) qui sotto per il credito una tantum che ricevono gli abbonati Pro.
+
+
## Modelli di testo
### Chat Completions
@@ -435,3 +439,5 @@ Questi costi si applicano in aggiunta al prezzo standard dei token del modello.
### Utenti Pro
Gli abbonati Pro ricevono un credito API una tantum di $10 al momento dell'upgrade a Pro. Usalo per testare e creare piccole app.
+
+Oltre a quel credito, l'uso dell'API è fatturato secondo le stesse tariffe pay-per-use elencate sopra — l'abbonamento Pro in sé non include quote API aggiuntive come immagini, caratteri o token inclusi. Alcuni modelli sono riservati agli account Pro (`PRO_ONLY_MODEL`); chiamarli da un account senza un abbonamento Pro attivo restituisce `AUTHENTICATION_FAILED_INACTIVE_KEY`. Vedi [Codici di errore](/api-reference/error-codes).
diff --git a/ko/guides/media/video-generation.mdx b/ko/guides/media/video-generation.mdx
index b89fcb7f..9f37d02f 100644
--- a/ko/guides/media/video-generation.mdx
+++ b/ko/guides/media/video-generation.mdx
@@ -339,6 +339,20 @@ Image-to-video 모델의 경우 `image_url`을 통해 원본 이미지를 전달
견적은 USD 단위입니다.
+
+**견적 파라미터는 가격 산정 input 전용입니다.** `/video/quote`에 전송하는 필드(`aspect_ratio`, `audio`, `reference_video_total_duration` 포함)는 순전히 가격을 계산하는 데만 사용됩니다. 이 필드들은 `/video/queue`로 전달되지 **않으며** 생성되는 비디오에 영향을 주지 않습니다. quote에 `aspect_ratio`를 보내는 것은 생성 시점에 `aspect_ratio`를 거부하는 모델(예: `seedance-2-0-image-to-video`)에도 허용되는데, 이는 image-to-video 모델이 입력 이미지에서 출력 종횡비를 도출하기 때문입니다.
+
+
+### Reference-to-video 가격
+
+R2V 모델(예: Seedance 2.0 R2V)의 경우 `reference_video_total_duration`(포함하려는 모든 레퍼런스 클립의 총 길이(초))을 전달하세요. 그러면 견적이 "input with video" 요율 구간과 `(input + output) × pixels` 토큰 공식을 반영합니다. 이를 생략하면 견적은 no-reference 기준선을 반환합니다.
+
+`reference_video_total_duration`은 `/video/quote`에서만 인식됩니다. `/video/queue`에는 영향을 주지 않으며 생략해도 생성 오류가 발생하지 않습니다.
+
+### 안정적인 가격 표시
+
+견적은 특정 시점 기준이며 가격은 변경될 수 있습니다. 앱에서 고정 가격을 표시하려면 지원하는 각 파라미터 조합에 대해 `/video/quote`를 한 번 호출하고 결과를 자체 저장소에 캐시하세요. 그런 다음 캐시된 값을 갱신하기 위해 일정에 따라(또는 가격표 업데이트 시) 다시 견적을 요청하세요. "잠긴(locked)" 또는 "정적(static)" 견적 endpoint는 없습니다.
+
---
## 에러
diff --git a/ko/overview/pricing.mdx b/ko/overview/pricing.mdx
index 1156dc20..e530444f 100644
--- a/ko/overview/pricing.mdx
+++ b/ko/overview/pricing.mdx
@@ -7,6 +7,10 @@ description: "텍스트, 이미지, 비디오, 오디오, 임베딩 모델별 10
별도 표기가 없는 한 100만 토큰당 가격입니다. 모든 가격은 USD 기준입니다. 1 Diem = 하루 $1 상당의 컴퓨트.
+
+**API 요금제 vs. 소비자 요금제.** Venice API는 USD 크레딧(또는 스테이킹된 DIEM)으로 **사용량 기반**으로 과금됩니다. 이는 Venice 소비자용 웹 앱의 월간 구독 요금제(Free, Pro, Max)와는 별개이며, 이러한 요금제의 사용 한도(이미지 수량 또는 무제한 채팅 등)는 웹/데스크톱/모바일 앱에만 적용되고 API 사용에는 **적용되지 않습니다**. 모든 API 호출은 소비자 요금제와 관계없이 API 크레딧 잔액에서 차감됩니다. Pro 구독자가 받는 일회성 크레딧에 대해서는 아래 [Pro 사용자](#pro-사용자)를 참고하세요.
+
+
## 텍스트 모델
### Chat Completions
@@ -435,3 +439,5 @@ description: "텍스트, 이미지, 비디오, 오디오, 임베딩 모델별 10
### Pro 사용자
Pro 구독자는 Pro로 업그레이드 시 일회성 $10 API 크레딧을 받습니다. 작은 앱을 테스트하고 빌드하는 데 사용하세요.
+
+이 크레딧을 넘어선 API 사용은 위에 나열된 것과 동일한 사용량 기반 요율로 과금됩니다. Pro 구독 자체에는 포함된 이미지, 문자, 토큰과 같은 추가 API 사용 한도가 포함되어 있지 않습니다. 일부 모델은 Pro 계정으로 제한됩니다(`PRO_ONLY_MODEL`). 활성 Pro 구독이 없는 계정에서 해당 모델을 호출하면 `AUTHENTICATION_FAILED_INACTIVE_KEY`가 반환됩니다. [Error Codes](/api-reference/error-codes)를 참고하세요.
diff --git a/overview/pricing.mdx b/overview/pricing.mdx
index b0370674..ecf3e1ee 100644
--- a/overview/pricing.mdx
+++ b/overview/pricing.mdx
@@ -1,5 +1,6 @@
---
title: API Pricing
+description: Pay-per-use pricing for Venice API models — chat, embeddings, images, video, audio, and web search — plus payment options and Pro credits.
"og:title": "Pricing | Venice API Docs"
"og:description": "Learn about pricing for Venice's API."
---
diff --git a/pt-BR/guides/media/video-generation.mdx b/pt-BR/guides/media/video-generation.mdx
index f00af38a..7138b81f 100644
--- a/pt-BR/guides/media/video-generation.mdx
+++ b/pt-BR/guides/media/video-generation.mdx
@@ -339,6 +339,20 @@ Obtenha o custo exato antes de gerar. Envie apenas inputs de preço (`model`, `d
A cotação está em USD.
+
+**Os parâmetros de cotação são apenas inputs de preço.** Os campos que você envia para `/video/quote` — incluindo `aspect_ratio`, `audio` e `reference_video_total_duration` — são usados exclusivamente para calcular o preço. Eles **não** são encaminhados para `/video/queue` e não afetam o vídeo gerado. Enviar `aspect_ratio` para a cotação é aceito mesmo para modelos (como `seedance-2-0-image-to-video`) que rejeitam `aspect_ratio` no momento da geração, já que modelos image-to-video derivam o aspect ratio de saída a partir da imagem de entrada.
+
+
+### Preços de reference-to-video
+
+Para modelos R2V (por exemplo, Seedance 2.0 R2V), passe `reference_video_total_duration` — a duração agregada em segundos de todos os clipes de referência que você planeja incluir — para que a cotação reflita a faixa de preço "input with video" e a fórmula de tokens `(input + output) × pixels`. Omita-o e a cotação retornará a linha de base sem referência.
+
+`reference_video_total_duration` só é reconhecido por `/video/quote`. Ele não tem efeito em `/video/queue` e omiti-lo não causará erro de geração.
+
+### Exibindo preços estáveis
+
+As cotações são pontuais e os preços podem mudar. Se você quiser exibir um preço fixo no seu app, chame `/video/quote` uma vez para cada combinação de parâmetros que você suporta e faça cache do resultado no seu próprio store — depois refaça a cotação em um schedule (ou em atualizações da lista de preços) para renovar o valor em cache. Não existe endpoint de cotação "travada" ou "estática".
+
---
## Erros
diff --git a/pt-BR/overview/pricing.mdx b/pt-BR/overview/pricing.mdx
index dfc013db..215e2634 100644
--- a/pt-BR/overview/pricing.mdx
+++ b/pt-BR/overview/pricing.mdx
@@ -7,6 +7,10 @@ description: "Preços da Venice API por 1M de tokens para modelos de texto, imag
Preços por 1M de tokens salvo indicação. Todos os preços em USD. 1 Diem = $1/dia de computação.
+
+**Planos de API vs. consumidor.** A Venice API é cobrada em modelo **pay-per-use** em créditos USD (ou via DIEM em staking). Ela é separada dos planos de assinatura mensal do app web para consumidores da Venice (Free, Pro, Max), cujas cotas — como contagem de imagens ou chat ilimitado — se aplicam apenas aos apps web/desktop/mobile, **não** ao uso da API. Todas as chamadas de API são medidas contra o saldo de créditos da sua API, independentemente do seu plano de consumidor. Veja [Usuários Pro](#usuários-pro) abaixo para o crédito único que os assinantes Pro recebem.
+
+
## Modelos de texto
### Chat Completions
@@ -435,3 +439,5 @@ Essas cobranças se aplicam além dos preços padrão por token do modelo.
### Usuários Pro
Assinantes Pro recebem um crédito único de $10 na API ao fazer upgrade para Pro. Use-o para testar e construir pequenos apps.
+
+Além desse crédito, o uso da API é cobrado pelas mesmas tarifas pay-per-use listadas acima — a assinatura Pro em si não inclui cotas adicionais de API, como imagens, caracteres ou tokens inclusos. Alguns modelos são restritos a contas Pro (`PRO_ONLY_MODEL`); chamá-los a partir de uma conta sem uma assinatura Pro ativa retorna `AUTHENTICATION_FAILED_INACTIVE_KEY`. Veja [Códigos de erro](/api-reference/error-codes).
diff --git a/zh/guides/media/video-generation.mdx b/zh/guides/media/video-generation.mdx
index 14e8da84..625ab1a3 100644
--- a/zh/guides/media/video-generation.mdx
+++ b/zh/guides/media/video-generation.mdx
@@ -339,6 +339,20 @@ await fetch(`${BASE_URL}/video/complete`, {
报价以美元为单位。
+
+**报价参数仅用作定价输入。** 您发送到 `/video/quote` 的字段——包括 `aspect_ratio`、`audio` 和 `reference_video_total_duration`——仅用于计算价格。它们**不会**被转发到 `/video/queue`，也不会影响生成的视频。即使某些模型（例如 `seedance-2-0-image-to-video`）在生成时会拒绝 `aspect_ratio`，向 quote 发送 `aspect_ratio` 也是可接受的，因为 image-to-video 模型会从输入图像推导出输出宽高比。
+
+
+### 参考视频到视频的定价
+
+对于 R2V 模型（例如 Seedance 2.0 R2V），请传递 `reference_video_total_duration`——即您计划包含的所有参考剪辑的总时长（以秒为单位）——以便报价反映"带视频输入"的费率层级以及 `(输入 + 输出) × 像素` 的 token 公式。如果省略它，报价将改为返回无参考的基线值。
+
+`reference_video_total_duration` 仅被 `/video/quote` 识别。它对 `/video/queue` 没有影响，省略它也不会导致生成错误。
+
+### 显示稳定价格
+
+报价是时点性的，价格可能会变化。如果您希望在应用中显示固定价格，请对您支持的每种参数组合调用一次 `/video/quote`，并将结果缓存到您自己的存储中——然后按计划（或在价格表更新时）重新报价以刷新缓存的值。不存在"锁定"或"静态"的报价端点。
+
---
## 错误
diff --git a/zh/overview/pricing.mdx b/zh/overview/pricing.mdx
index 9fd31fa1..e7fcef78 100644
--- a/zh/overview/pricing.mdx
+++ b/zh/overview/pricing.mdx
@@ -7,6 +7,10 @@ description: "Venice API 定价：文本、图像、视频、音频和嵌入模
除非另有说明，价格按每 1M token 计。所有价格以美元计。1 Diem = $1/天 的计算量。
+
+**API 与消费者套餐。** Venice API 按**按量付费**方式以美元 credit 计费（或通过质押 DIEM）。它与 Venice 消费者 Web 应用的月度订阅套餐（Free、Pro、Max）是分开的，那些套餐的额度——例如图像次数或无限聊天——仅适用于 Web/桌面/移动应用，**不**适用于 API 使用。所有 API 调用都会按您的 API credit 余额计量，与您的消费者套餐无关。请参阅下方的 [Pro 用户](#pro-用户) 了解 Pro 订阅者获得的一次性 credit。
+
+
## 文本模型
### Chat Completions
@@ -435,3 +439,5 @@ description: "Venice API 定价：文本、图像、视频、音频和嵌入模
### Pro 用户
升级到 Pro 时，Pro 订阅者会获得一次性 $10 API credit。用它来测试和构建小型应用。
+
+除此 credit 外，API 使用仍按上文列出的相同按量付费费率计费——Pro 订阅本身不包含额外的 API 额度，例如包含的图像、字符或 token。某些模型仅限 Pro 账户使用（`PRO_ONLY_MODEL`）；从没有有效 Pro 订阅的账户调用它们会返回 `AUTHENTICATION_FAILED_INACTIVE_KEY`。请参阅[错误代码](/api-reference/error-codes)。