From 7ca1514995e7bca43dbe3b7aa94f3694c32d2d52 Mon Sep 17 00:00:00 2001
From: Tadas Petra <60107328+tadaspetra@users.noreply.github.com>
Date: Tue, 14 Jul 2026 19:38:19 -0500
Subject: [PATCH 1/2] use the new projects api

---
 dubbing/nextjs/quickstart/PROMPT.md           | 37 +++++----
 dubbing/nextjs/quickstart/README.md           |  2 +-
 dubbing/nextjs/quickstart/example/README.md   |  2 +-
 .../[dubbingId]/audio/[languageCode]/route.ts | 83 -------------------
 .../[projectId]/audio/[languageId]/route.ts   | 71 ++++++++++++++++
 .../{[dubbingId] => [projectId]}/route.ts     | 28 +++++--
 .../example/app/api/dubbing/route.ts          | 15 ++--
 .../nextjs/quickstart/example/app/page.tsx    | 61 +++++++-------
 .../nextjs/quickstart/example/package.json    |  2 +-
 9 files changed, 154 insertions(+), 147 deletions(-)
 delete mode 100644 dubbing/nextjs/quickstart/example/app/api/dubbing/[dubbingId]/audio/[languageCode]/route.ts
 create mode 100644 dubbing/nextjs/quickstart/example/app/api/dubbing/[projectId]/audio/[languageId]/route.ts
 rename dubbing/nextjs/quickstart/example/app/api/dubbing/{[dubbingId] => [projectId]}/route.ts (60%)

diff --git a/dubbing/nextjs/quickstart/PROMPT.md b/dubbing/nextjs/quickstart/PROMPT.md
index fa2530cc..0cdb1201 100644
--- a/dubbing/nextjs/quickstart/PROMPT.md
+++ b/dubbing/nextjs/quickstart/PROMPT.md
@@ -1,33 +1,36 @@
 Before writing any code, invoke the `/text-to-speech` skill to learn the correct ElevenLabs SDK patterns.
 
+This example uses the Dubbing Projects API (dubbing v2): a **project** holds the source media and its transcript, and each **language target** produces one dubbed output.
+
 ## 1. `app/api/dubbing/route.ts`
 
-Secure POST endpoint that starts a dubbing job from an uploaded recording.
+Secure POST endpoint that starts a dubbing project from an uploaded recording.
 
 - Read `ELEVENLABS_API_KEY` from `process.env`. Return 500 if missing.
 - Accept `audio` (File), `targetLang` (string), and optional `sourceLang` (string, default `auto`) from request `FormData`.
 - Return 400 for missing or invalid audio, or a missing `targetLang`.
-- Use `ElevenLabsClient` and call `client.dubbing.create({ file: audio, targetLang, sourceLang: sourceLang === "auto" ? undefined : sourceLang, name: "Browser dubbing demo" })`.
-- Read the job id from the SDK response (`dubbingId`) and return JSON `{ dubbingId, expectedDurationSec }`.
+- Use `ElevenLabsClient` and call `client.dubbing.project.create({ file: audio, targetLanguage: targetLang, sourceLanguage: sourceLang === "auto" ? undefined : sourceLang, modelId: "dubbing_v2", reference: "Browser dubbing demo" })`. The `targetLanguage` shortcut also queues a language target that starts automatically once the project finishes transcribing.
+- Return JSON `{ projectId, languageId }`, reading `languageId` from `project.languageIds?.[0] ?? null`.
 - Wrap failures in readable JSON errors.
 
-## 2. `app/api/dubbing/[dubbingId]/route.ts`
+## 2. `app/api/dubbing/[projectId]/route.ts`
 
-Secure GET endpoint that returns dubbing status metadata for polling.
+Secure GET endpoint that returns combined project and language status for polling.
 
-- Read and validate `dubbingId` from the route params.
-- Call `client.dubbing.get(dubbingId)`.
-- Return JSON with `status`, `error`, `sourceLanguage`, and `targetLanguages`.
+- Read and validate `projectId` from the route params.
+- Call `client.dubbing.project.get(projectId)`. Project statuses are `queued`, `preparing`, `processing`, `ready`, or `failed`.
+- If the project has a language target (`project.languageIds?.[0]`), also call `client.dubbing.project.language.get(projectId, languageId)`. Language statuses are `queued`, `processing`, `completed`, `stale`, or `failed`.
+- Return JSON with `projectStatus`, `languageId`, and `languageStatus`.
 - Keep the response small and friendly for client polling.
 
-## 3. `app/api/dubbing/[dubbingId]/audio/[languageCode]/route.ts`
+## 3. `app/api/dubbing/[projectId]/audio/[languageId]/route.ts`
 
-Secure GET endpoint that proxies the dubbed audio file.
+Secure GET endpoint that proxies the dubbed audio output.
 
-- Read and validate `dubbingId` and `languageCode` from the route params.
-- Call `client.dubbing.audio.get(dubbingId, languageCode)`.
-- Collect the returned stream into a `Buffer` and respond with `audio/mpeg`.
-- Return readable JSON errors when the dub is not ready or fails.
+- Read and validate `projectId` and `languageId` from the route params.
+- Call `client.dubbing.project.language.get(projectId, languageId)`. Once the language is `completed`, `outputs.losslessAudio` carries a signed, time-limited download URL.
+- Return 503 with a readable JSON error if the language is not `completed` yet or has no output URL.
+- Fetch the signed URL server-side and stream the body back with the upstream content type (default `audio/wav`).
 
 ## 4. `app/page.tsx`
 
@@ -38,8 +41,8 @@ In-browser voice recorder and dubbing page.
 - After stopping, convert the recorded blob to a WAV `File` in the browser before upload. Do not send raw `audio/webm;codecs=opus` to `/api/dubbing`, because the Dubbing API rejects that content type.
 - Show clear states: idle, recording, preparing, polling, ready, and error. While recording, show elapsed time and a pulsing red indicator.
 - After recording, show the original audio player plus source-language and target-language selects. Prevent choosing the same explicit source and target language.
-- On **Dub Recording**, `POST` `FormData` with the converted WAV file to `/api/dubbing`.
-- Poll `/api/dubbing/${dubbingId}` every 5 seconds until the status is `dubbed`; stop early and show the API error if one is returned.
-- When ready, fetch `/api/dubbing/${dubbingId}/audio/${targetLang}`, create an object URL, and render a dubbed `<audio>` player with controls plus a download link.
+- On **Dub Recording**, `POST` `FormData` with the converted WAV file to `/api/dubbing` and keep the returned `projectId`.
+- Poll `/api/dubbing/${projectId}` every 5 seconds. While polling, show "Transcribing your recording…" until `projectStatus` is `ready`, then "Generating the dubbed audio…". Stop with an error if `projectStatus` or `languageStatus` is `failed`.
+- When `languageStatus` is `completed`, fetch `/api/dubbing/${projectId}/audio/${languageId}`, create an object URL, and render a dubbed `<audio>` player with controls plus a WAV download link.
 - Display inline errors for microphone denial, upload failures, and dubbing failures.
 - Keep the UI minimal and easy to scan.
diff --git a/dubbing/nextjs/quickstart/README.md b/dubbing/nextjs/quickstart/README.md
index 905c3770..ed7cedf2 100644
--- a/dubbing/nextjs/quickstart/README.md
+++ b/dubbing/nextjs/quickstart/README.md
@@ -1,6 +1,6 @@
 # Dubbing Recorder (Next.js)
 
-Record your voice in the browser, dub it into another language with the ElevenLabs Dubbing API, and play or download the result.
+Record your voice in the browser, dub it into another language with the ElevenLabs Dubbing API (v2, Dubbing Projects), and play or download the result.
 
 ## Setup
 
diff --git a/dubbing/nextjs/quickstart/example/README.md b/dubbing/nextjs/quickstart/example/README.md
index 905c3770..ed7cedf2 100644
--- a/dubbing/nextjs/quickstart/example/README.md
+++ b/dubbing/nextjs/quickstart/example/README.md
@@ -1,6 +1,6 @@
 # Dubbing Recorder (Next.js)
 
-Record your voice in the browser, dub it into another language with the ElevenLabs Dubbing API, and play or download the result.
+Record your voice in the browser, dub it into another language with the ElevenLabs Dubbing API (v2, Dubbing Projects), and play or download the result.
 
 ## Setup
 
diff --git a/dubbing/nextjs/quickstart/example/app/api/dubbing/[dubbingId]/audio/[languageCode]/route.ts b/dubbing/nextjs/quickstart/example/app/api/dubbing/[dubbingId]/audio/[languageCode]/route.ts
deleted file mode 100644
index 649aeccb..00000000
--- a/dubbing/nextjs/quickstart/example/app/api/dubbing/[dubbingId]/audio/[languageCode]/route.ts
+++ /dev/null
@@ -1,83 +0,0 @@
-import { ElevenLabsClient, ElevenLabsError } from "@elevenlabs/elevenlabs-js";
-import { NextResponse } from "next/server";
-
-function jsonError(message: string, status: number) {
-  return NextResponse.json({ error: message }, { status });
-}
-
-function isValidId(id: string) {
-  return /^[a-zA-Z0-9_-]+$/.test(id) && id.length > 0 && id.length <= 128;
-}
-
-function isValidLanguageCode(code: string) {
-  return /^[a-z]{2,3}(-[a-z]{2})?$/i.test(code);
-}
-
-async function streamToBuffer(
-  stream: ReadableStream<Uint8Array>
-): Promise<Buffer> {
-  const reader = stream.getReader();
-  const chunks: Uint8Array[] = [];
-  try {
-    for (;;) {
-      const { done, value } = await reader.read();
-      if (done) break;
-      if (value) chunks.push(value);
-    }
-  } finally {
-    reader.releaseLock();
-  }
-  return Buffer.concat(chunks.map(c => Buffer.from(c)));
-}
-
-export async function GET(
-  _request: Request,
-  {
-    params,
-  }: {
-    params: Promise<{ dubbingId: string; languageCode: string }>;
-  }
-) {
-  const apiKey = process.env.ELEVENLABS_API_KEY;
-  if (!apiKey) {
-    return jsonError("Server is missing ELEVENLABS_API_KEY.", 500);
-  }
-
-  const { dubbingId, languageCode: languageCodeRaw } = await params;
-  const languageCode = decodeURIComponent(languageCodeRaw ?? "");
-
-  if (!dubbingId || !isValidId(dubbingId)) {
-    return jsonError("Invalid dubbing id.", 400);
-  }
-  if (!languageCode || !isValidLanguageCode(languageCode)) {
-    return jsonError("Invalid language code.", 400);
-  }
-
-  const client = new ElevenLabsClient({ apiKey });
-
-  try {
-    const stream = await client.dubbing.audio.get(dubbingId, languageCode);
-    const buf = await streamToBuffer(stream);
-    return new NextResponse(new Uint8Array(buf), {
-      status: 200,
-      headers: {
-        "Content-Type": "audio/mpeg",
-        "Cache-Control": "private, max-age=3600",
-      },
-    });
-  } catch (e) {
-    if (e instanceof ElevenLabsError) {
-      const status = e.statusCode ?? 502;
-      if (status === 425) {
-        return jsonError("Dubbed audio is not ready yet.", 503);
-      }
-      return jsonError(
-        e.message || "Failed to fetch dubbed audio.",
-        status >= 400 && status < 600 ? status : 502
-      );
-    }
-    const message =
-      e instanceof Error ? e.message : "Failed to fetch dubbed audio.";
-    return jsonError(message, 502);
-  }
-}
diff --git a/dubbing/nextjs/quickstart/example/app/api/dubbing/[projectId]/audio/[languageId]/route.ts b/dubbing/nextjs/quickstart/example/app/api/dubbing/[projectId]/audio/[languageId]/route.ts
new file mode 100644
index 00000000..724b7cd6
--- /dev/null
+++ b/dubbing/nextjs/quickstart/example/app/api/dubbing/[projectId]/audio/[languageId]/route.ts
@@ -0,0 +1,71 @@
+import { ElevenLabsClient, ElevenLabsError } from "@elevenlabs/elevenlabs-js";
+import { NextResponse } from "next/server";
+
+function jsonError(message: string, status: number) {
+  return NextResponse.json({ error: message }, { status });
+}
+
+function isValidId(id: string) {
+  return /^[a-zA-Z0-9_-]+$/.test(id) && id.length > 0 && id.length <= 128;
+}
+
+export async function GET(
+  _request: Request,
+  {
+    params,
+  }: {
+    params: Promise<{ projectId: string; languageId: string }>;
+  }
+) {
+  const apiKey = process.env.ELEVENLABS_API_KEY;
+  if (!apiKey) {
+    return jsonError("Server is missing ELEVENLABS_API_KEY.", 500);
+  }
+
+  const { projectId, languageId } = await params;
+  if (!projectId || !isValidId(projectId)) {
+    return jsonError("Invalid project id.", 400);
+  }
+  if (!languageId || !isValidId(languageId)) {
+    return jsonError("Invalid language id.", 400);
+  }
+
+  const client = new ElevenLabsClient({ apiKey });
+
+  try {
+    const language = await client.dubbing.project.language.get(
+      projectId,
+      languageId
+    );
+
+    // outputs carries a signed, time-limited download URL once completed.
+    const outputUrl = language.outputs?.losslessAudio;
+    if (language.status !== "completed" || !outputUrl) {
+      return jsonError("Dubbed audio is not ready yet.", 503);
+    }
+
+    const upstream = await fetch(outputUrl);
+    if (!upstream.ok || !upstream.body) {
+      return jsonError("Failed to download dubbed audio.", 502);
+    }
+
+    return new NextResponse(upstream.body, {
+      status: 200,
+      headers: {
+        "Content-Type": upstream.headers.get("content-type") ?? "audio/wav",
+        "Cache-Control": "private, max-age=3600",
+      },
+    });
+  } catch (e) {
+    if (e instanceof ElevenLabsError) {
+      const status = e.statusCode ?? 502;
+      return jsonError(
+        e.message || "Failed to fetch dubbed audio.",
+        status >= 400 && status < 600 ? status : 502
+      );
+    }
+    const message =
+      e instanceof Error ? e.message : "Failed to fetch dubbed audio.";
+    return jsonError(message, 502);
+  }
+}
diff --git a/dubbing/nextjs/quickstart/example/app/api/dubbing/[dubbingId]/route.ts b/dubbing/nextjs/quickstart/example/app/api/dubbing/[projectId]/route.ts
similarity index 60%
rename from dubbing/nextjs/quickstart/example/app/api/dubbing/[dubbingId]/route.ts
rename to dubbing/nextjs/quickstart/example/app/api/dubbing/[projectId]/route.ts
index 11504262..d5c40818 100644
--- a/dubbing/nextjs/quickstart/example/app/api/dubbing/[dubbingId]/route.ts
+++ b/dubbing/nextjs/quickstart/example/app/api/dubbing/[projectId]/route.ts
@@ -11,27 +11,37 @@ function isValidId(id: string) {
 
 export async function GET(
   _request: Request,
-  { params }: { params: Promise<{ dubbingId: string }> }
+  { params }: { params: Promise<{ projectId: string }> }
 ) {
   const apiKey = process.env.ELEVENLABS_API_KEY;
   if (!apiKey) {
     return jsonError("Server is missing ELEVENLABS_API_KEY.", 500);
   }
 
-  const { dubbingId } = await params;
-  if (!dubbingId || !isValidId(dubbingId)) {
-    return jsonError("Invalid dubbing id.", 400);
+  const { projectId } = await params;
+  if (!projectId || !isValidId(projectId)) {
+    return jsonError("Invalid project id.", 400);
   }
 
   const client = new ElevenLabsClient({ apiKey });
 
   try {
-    const meta = await client.dubbing.get(dubbingId);
+    const project = await client.dubbing.project.get(projectId);
+    const languageId = project.languageIds?.[0] ?? null;
+
+    let languageStatus: string | null = null;
+    if (languageId) {
+      const language = await client.dubbing.project.language.get(
+        projectId,
+        languageId
+      );
+      languageStatus = language.status;
+    }
+
     return NextResponse.json({
-      status: meta.status,
-      error: meta.error ?? null,
-      sourceLanguage: meta.sourceLanguage ?? null,
-      targetLanguages: meta.targetLanguages ?? [],
+      projectStatus: project.status,
+      languageId,
+      languageStatus,
     });
   } catch (e) {
     if (e instanceof ElevenLabsError) {
diff --git a/dubbing/nextjs/quickstart/example/app/api/dubbing/route.ts b/dubbing/nextjs/quickstart/example/app/api/dubbing/route.ts
index 6662dd17..63ee54bc 100644
--- a/dubbing/nextjs/quickstart/example/app/api/dubbing/route.ts
+++ b/dubbing/nextjs/quickstart/example/app/api/dubbing/route.ts
@@ -42,16 +42,19 @@ export async function POST(request: Request) {
   const client = new ElevenLabsClient({ apiKey });
 
   try {
-    const result = await client.dubbing.create({
+    // The targetLanguage shortcut also queues a language target, which starts
+    // automatically once the project finishes transcribing.
+    const project = await client.dubbing.project.create({
       file: audio,
-      targetLang,
-      sourceLang: sourceLang === "auto" ? undefined : sourceLang,
-      name: "Browser dubbing demo",
+      targetLanguage: targetLang,
+      sourceLanguage: sourceLang === "auto" ? undefined : sourceLang,
+      modelId: "dubbing_v2",
+      reference: "Browser dubbing demo",
     });
 
     return NextResponse.json({
-      dubbingId: result.dubbingId,
-      expectedDurationSec: result.expectedDurationSec,
+      projectId: project.projectId,
+      languageId: project.languageIds?.[0] ?? null,
     });
   } catch (e) {
     if (e instanceof ElevenLabsError) {
diff --git a/dubbing/nextjs/quickstart/example/app/page.tsx b/dubbing/nextjs/quickstart/example/app/page.tsx
index ebc1bcc2..d3a8c116 100644
--- a/dubbing/nextjs/quickstart/example/app/page.tsx
+++ b/dubbing/nextjs/quickstart/example/app/page.tsx
@@ -52,8 +52,9 @@ export default function Home() {
   const [wavFile, setWavFile] = useState<File | null>(null);
   const [originalUrl, setOriginalUrl] = useState<string | null>(null);
 
-  const [dubbingId, setDubbingId] = useState<string | null>(null);
+  const [projectId, setProjectId] = useState<string | null>(null);
   const [dubbedUrl, setDubbedUrl] = useState<string | null>(null);
+  const [pollNote, setPollNote] = useState<string | null>(null);
 
   const mediaRecorderRef = useRef<MediaRecorder | null>(null);
   const streamRef = useRef<MediaStream | null>(null);
@@ -87,7 +88,7 @@ export default function Home() {
       if (prev) URL.revokeObjectURL(prev);
       return null;
     });
-    setDubbingId(null);
+    setProjectId(null);
 
     try {
       const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
@@ -179,7 +180,8 @@ export default function Home() {
       return null;
     });
     setPhase("polling");
-    setDubbingId(null);
+    setProjectId(null);
+    setPollNote(null);
 
     const body = new FormData();
     body.set("audio", wavFile);
@@ -189,8 +191,8 @@ export default function Home() {
     try {
       const res = await fetch("/api/dubbing", { method: "POST", body });
       const data = (await res.json()) as {
-        dubbingId?: string;
-        expectedDurationSec?: number;
+        projectId?: string;
+        languageId?: string | null;
         error?: string;
       };
       if (!res.ok) {
@@ -198,12 +200,12 @@ export default function Home() {
         setPhase("error");
         return;
       }
-      if (!data.dubbingId) {
-        setError("Missing dubbing id in response.");
+      if (!data.projectId) {
+        setError("Missing project id in response.");
         setPhase("error");
         return;
       }
-      setDubbingId(data.dubbingId);
+      setProjectId(data.projectId);
     } catch (e) {
       setError(e instanceof Error ? e.message : "Upload failed.");
       setPhase("error");
@@ -211,7 +213,7 @@ export default function Home() {
   };
 
   useEffect(() => {
-    if (phase !== "polling" || !dubbingId) return;
+    if (phase !== "polling" || !projectId) return;
 
     let cancelled = false;
     let timeoutId: ReturnType<typeof setTimeout> | null = null;
@@ -219,42 +221,38 @@ export default function Home() {
     const poll = async () => {
       try {
         const res = await fetch(
-          `/api/dubbing/${encodeURIComponent(dubbingId)}`
+          `/api/dubbing/${encodeURIComponent(projectId)}`
         );
         const data = (await res.json()) as {
-          status?: string;
-          error?: string | null;
-          sourceLanguage?: string | null;
-          targetLanguages?: string[];
+          projectStatus?: string;
+          languageId?: string | null;
+          languageStatus?: string | null;
+          error?: string;
         };
 
         if (cancelled) return;
 
         if (!res.ok) {
-          setError(
-            (data as { error?: string }).error ?? "Status request failed."
-          );
+          setError(data.error ?? "Status request failed.");
           setPhase("error");
           return;
         }
 
-        if (data.error) {
-          setError(data.error);
+        if (data.projectStatus === "failed") {
+          setError("Preparing the source audio failed.");
           setPhase("error");
           return;
         }
-
-        const st = data.status?.toLowerCase();
-        if (st === "failed") {
-          setError(data.error ?? "Dubbing failed.");
+        if (data.languageStatus === "failed") {
+          setError("Dubbing failed.");
           setPhase("error");
           return;
         }
 
-        if (st === "dubbed") {
+        if (data.languageStatus === "completed" && data.languageId) {
           try {
             const audioRes = await fetch(
-              `/api/dubbing/${encodeURIComponent(dubbingId)}/audio/${encodeURIComponent(targetLang)}`
+              `/api/dubbing/${encodeURIComponent(projectId)}/audio/${encodeURIComponent(data.languageId)}`
             );
             if (!audioRes.ok) {
               const errJson = (await audioRes.json().catch(() => ({}))) as {
@@ -282,6 +280,11 @@ export default function Home() {
           return;
         }
 
+        setPollNote(
+          data.projectStatus !== "ready"
+            ? "Transcribing your recording…"
+            : "Generating the dubbed audio…"
+        );
         timeoutId = setTimeout(poll, 5000);
       } catch (e) {
         if (!cancelled) {
@@ -297,7 +300,7 @@ export default function Home() {
       cancelled = true;
       if (timeoutId) clearTimeout(timeoutId);
     };
-  }, [phase, dubbingId, targetLang]);
+  }, [phase, projectId]);
 
   const sameLangBlocked = sourceLang !== "auto" && sourceLang === targetLang;
 
@@ -317,7 +320,7 @@ export default function Home() {
       case "preparing":
         return "Preparing audio…";
       case "polling":
-        return "Dubbing in progress… checking every 5s.";
+        return pollNote ?? "Dubbing in progress… checking every 5s.";
       case "ready":
         return "Dubbing complete.";
       case "error":
@@ -457,9 +460,9 @@ export default function Home() {
               <a
                 className="mt-2 inline-block text-sm text-neutral-900 underline"
                 href={dubbedUrl}
-                download={`dub-${targetLang}.mp3`}
+                download={`dub-${targetLang}.wav`}
               >
-                Download MP3
+                Download WAV
               </a>
             </div>
           ) : null}
diff --git a/dubbing/nextjs/quickstart/example/package.json b/dubbing/nextjs/quickstart/example/package.json
index 8d37bad2..6c018cf5 100644
--- a/dubbing/nextjs/quickstart/example/package.json
+++ b/dubbing/nextjs/quickstart/example/package.json
@@ -17,7 +17,7 @@
     "react": "19.2.3",
     "react-dom": "19.2.3",
     "tailwind-merge": "^3.5.0",
-    "@elevenlabs/elevenlabs-js": "^2.40.0"
+    "@elevenlabs/elevenlabs-js": "^2.58.0"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4",

From 1e3988e0e5fdfe248e2e9efb341a00290b265aef Mon Sep 17 00:00:00 2001
From: Tadas Petra <60107328+tadaspetra@users.noreply.github.com>
Date: Wed, 5 Aug 2026 18:52:05 -0500
Subject: [PATCH 2/2] Align dubbing example with official v2 docs

Drop the explicit modelId (the docs rely on the server default) and
match the docs' wording on the signed output URL expiry.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 dubbing/nextjs/quickstart/PROMPT.md                         | 6 +++---
 dubbing/nextjs/quickstart/README.md                         | 2 +-
 dubbing/nextjs/quickstart/example/README.md                 | 2 +-
 .../app/api/dubbing/[projectId]/audio/[languageId]/route.ts | 3 ++-
 dubbing/nextjs/quickstart/example/app/api/dubbing/route.ts  | 3 +--
 5 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/dubbing/nextjs/quickstart/PROMPT.md b/dubbing/nextjs/quickstart/PROMPT.md
index 0cdb1201..af287078 100644
--- a/dubbing/nextjs/quickstart/PROMPT.md
+++ b/dubbing/nextjs/quickstart/PROMPT.md
@@ -1,6 +1,6 @@
 Before writing any code, invoke the `/text-to-speech` skill to learn the correct ElevenLabs SDK patterns.
 
-This example uses the Dubbing Projects API (dubbing v2): a **project** holds the source media and its transcript, and each **language target** produces one dubbed output.
+This example uses the Dubbing Projects API (dubbing v2): a **project** holds the source media and its transcript, and each **language target** produces one dubbed output in a single language.
 
 ## 1. `app/api/dubbing/route.ts`
 
@@ -9,7 +9,7 @@ Secure POST endpoint that starts a dubbing project from an uploaded recording.
 - Read `ELEVENLABS_API_KEY` from `process.env`. Return 500 if missing.
 - Accept `audio` (File), `targetLang` (string), and optional `sourceLang` (string, default `auto`) from request `FormData`.
 - Return 400 for missing or invalid audio, or a missing `targetLang`.
-- Use `ElevenLabsClient` and call `client.dubbing.project.create({ file: audio, targetLanguage: targetLang, sourceLanguage: sourceLang === "auto" ? undefined : sourceLang, modelId: "dubbing_v2", reference: "Browser dubbing demo" })`. The `targetLanguage` shortcut also queues a language target that starts automatically once the project finishes transcribing.
+- Use `ElevenLabsClient` and call `client.dubbing.project.create({ file: audio, targetLanguage: targetLang, sourceLanguage: sourceLang === "auto" ? undefined : sourceLang, reference: "Browser dubbing demo" })`. The `targetLanguage` shortcut also queues a language target that starts generating automatically once the project finishes transcribing.
 - Return JSON `{ projectId, languageId }`, reading `languageId` from `project.languageIds?.[0] ?? null`.
 - Wrap failures in readable JSON errors.
 
@@ -28,7 +28,7 @@ Secure GET endpoint that returns combined project and language status for pollin
 Secure GET endpoint that proxies the dubbed audio output.
 
 - Read and validate `projectId` and `languageId` from the route params.
-- Call `client.dubbing.project.language.get(projectId, languageId)`. Once the language is `completed`, `outputs.losslessAudio` carries a signed, time-limited download URL.
+- Call `client.dubbing.project.language.get(projectId, languageId)`. Once the language is `completed`, `outputs.losslessAudio` carries a signed download URL that expires after about an hour; fetching the language again returns a fresh one.
 - Return 503 with a readable JSON error if the language is not `completed` yet or has no output URL.
 - Fetch the signed URL server-side and stream the body back with the upstream content type (default `audio/wav`).
 
diff --git a/dubbing/nextjs/quickstart/README.md b/dubbing/nextjs/quickstart/README.md
index ed7cedf2..2c529bff 100644
--- a/dubbing/nextjs/quickstart/README.md
+++ b/dubbing/nextjs/quickstart/README.md
@@ -1,6 +1,6 @@
 # Dubbing Recorder (Next.js)
 
-Record your voice in the browser, dub it into another language with the ElevenLabs Dubbing API (v2, Dubbing Projects), and play or download the result.
+Record your voice in the browser, dub it into another language with the ElevenLabs Dubbing API (Dubbing Projects), and play or download the result.
 
 ## Setup
 
diff --git a/dubbing/nextjs/quickstart/example/README.md b/dubbing/nextjs/quickstart/example/README.md
index ed7cedf2..2c529bff 100644
--- a/dubbing/nextjs/quickstart/example/README.md
+++ b/dubbing/nextjs/quickstart/example/README.md
@@ -1,6 +1,6 @@
 # Dubbing Recorder (Next.js)
 
-Record your voice in the browser, dub it into another language with the ElevenLabs Dubbing API (v2, Dubbing Projects), and play or download the result.
+Record your voice in the browser, dub it into another language with the ElevenLabs Dubbing API (Dubbing Projects), and play or download the result.
 
 ## Setup
 
diff --git a/dubbing/nextjs/quickstart/example/app/api/dubbing/[projectId]/audio/[languageId]/route.ts b/dubbing/nextjs/quickstart/example/app/api/dubbing/[projectId]/audio/[languageId]/route.ts
index 724b7cd6..326c8b14 100644
--- a/dubbing/nextjs/quickstart/example/app/api/dubbing/[projectId]/audio/[languageId]/route.ts
+++ b/dubbing/nextjs/quickstart/example/app/api/dubbing/[projectId]/audio/[languageId]/route.ts
@@ -38,7 +38,8 @@ export async function GET(
       languageId
     );
 
-    // outputs carries a signed, time-limited download URL once completed.
+    // outputs carries a signed download URL once the dub has completed. The
+    // URL expires after about an hour; fetching the language returns a fresh one.
     const outputUrl = language.outputs?.losslessAudio;
     if (language.status !== "completed" || !outputUrl) {
       return jsonError("Dubbed audio is not ready yet.", 503);
diff --git a/dubbing/nextjs/quickstart/example/app/api/dubbing/route.ts b/dubbing/nextjs/quickstart/example/app/api/dubbing/route.ts
index 63ee54bc..af85f95f 100644
--- a/dubbing/nextjs/quickstart/example/app/api/dubbing/route.ts
+++ b/dubbing/nextjs/quickstart/example/app/api/dubbing/route.ts
@@ -43,12 +43,11 @@ export async function POST(request: Request) {
 
   try {
     // The targetLanguage shortcut also queues a language target, which starts
-    // automatically once the project finishes transcribing.
+    // generating automatically once the project finishes transcribing.
     const project = await client.dubbing.project.create({
       file: audio,
       targetLanguage: targetLang,
       sourceLanguage: sourceLang === "auto" ? undefined : sourceLang,
-      modelId: "dubbing_v2",
       reference: "Browser dubbing demo",
     });