---
title: "共有プレビュー用の VideoProps を返す（認証不要・トークン認証）"
method: GET
path: "/api/v1/projects/{projectId}/preview-props"
tags: ["projects"]
---

# 共有プレビュー用の VideoProps を返す（認証不要・トークン認証）

`GET /api/v1/projects/{projectId}/preview-props`

## Request

- Base URL: `https://app.yukkurigen.com`
- URL: `https://app.yukkurigen.com/api/v1/projects/{projectId}/preview-props`
- Auth: HTTP bearer

## Path parameters

- `projectId` string, required

## Response `200`

成功（ok:true）またはトークンエラー（ok:false）。HTTP 200 で返すのは画面がエラー種別に応じた案内を出すため。

- union
  - object
    - `ok` true, required
    - `title` string, required
    - `videoProps` object, required
    - `durationInFrames` integer, required
    - `lineCount` integer, required
    - `linesWithAudio` integer, required
    - `expiresAt` string, date-time, required
  - object
    - `ok` false, required
    - `reason` 'expired' | 'revoked' | 'not_found', required

## Other responses

- `429`: 上限を越えた（接続元ごとに1分20回・プロジェクトごとに1分60回）。本文は { ok:false, reason:"rate_limited", code:"rate_limited", retryAfter }。Retry-After の秒数だけ待つ

---

[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)