---
title: "MP4 レンダー進捗＋出力URL"
method: GET
path: "/api/v1/projects/{projectId}/render/{renderId}/progress"
tags: ["projects"]
---

# MP4 レンダー進捗＋出力URL

`GET /api/v1/projects/{projectId}/render/{renderId}/progress`

## Request

- Base URL: `https://app.yukkurigen.com`
- URL: `https://app.yukkurigen.com/api/v1/projects/{projectId}/render/{renderId}/progress`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Path parameters

- `projectId` string, required
- `renderId` string, required

## Response `200`

進捗

- object: 成功は done===true かつ outputFile が非空。失敗は fatalErrorEncountered===true、または done===true なのに outputFile が空。失敗でも done が立つため、必ず失敗判定を先に行うこと。
  - `done` boolean: レンダーが終了したか。**成功とは限らない** — 失敗（チャンク欠落、および後追いで確定した分）でも true になる。必ず失敗判定を先に行うこと。
  - `overallProgress` number
  - `outputFile` string, nullable: 成功時のみ非空。成功条件は done===true かつ outputFile が非空。
  - `errors` object[], nullable: Lambda 側のエラー。リトライ予定のものも含むので、失敗判定には使わないこと。
    - `message` string
    - `isFatal` boolean
    - `willRetry` boolean
  - `fatalErrorEncountered` boolean: true なら失敗が確定（リトライ不能）。done より先にこれを見ること。
  - `retried` boolean: Lambda 側の一時的な失敗（強制終了・素材の取得の停止・AWS の容量不足や頻度の上限）で、サーバが自動で1回焼き直したか。焼き直している間は done:false・fatalErrorEncountered:false のまま進捗が 0 から数え直すので、ポーリングを続けること。クレジットは押さえたまま（追加の消費なし）。焼き直しも失敗したら fatalErrorEncountered が立ち、返金される。
  - `renderId` string: このレンダーのID（リクエストの renderId と同じ）。
  - `credits` string: 完成したとき（done かつ outputFile）だけ。YouTube の概要欄に貼るクレジット（使った声・素材の表記。VOICEVOX の表記は利用規約の条件）。MCP の get_render も同じ値を返す。upload（YouTube 投稿）は自動で足す

## Other responses

- `401`: 未認証（code: unauthenticated）
- `402`: APIキー利用に有料プランが必要（code: plan_required、purchaseUrl 同梱）
- `403`: APIキーに projects:read スコープが無い、または他人のプロジェクト（code: insufficient_scope / forbidden）。
- `404`: 対象が無い（code: not_found）
- `429`: ポーリング頻度の上限（code: rate_limited）
- `500`: 進捗の取得に失敗（code: progress_unavailable）。レンダーは継続している可能性があるため、打ち切らず再試行すること。

## Changes

- **2026-10-20** `ba5f36b016da`: 30 warning, 19 info
  - added the new `already_subscribed` enum value to the `code` response property for the response status `401`
  - added the new `already_subscribed` enum value to the `code` response property for the response status `402`
  - added the new `already_subscribed` enum value to the `code` response property for the response status `403`
  - added the new `already_subscribed` enum value to the `code` response property for the response status `404`
  - …45 more

[Operation history](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/changes/api/v1/projects/:projectId/render/:renderId/progress/get.md)

---

[API](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api.md) · [All operations](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/llms.txt) · [OpenAPI document](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/revisions/ba5f36b016da?raw)