# 吹替クイックスタート

この文書は英語版 [Dubbing Quickstart](/content/docs/dubbing-quickstart/index.html) の日本語訳です。最終同期: 2026年3月17日。

5分で音声・動画を他の言語に吹替できます。SDKは不要 — REST APIコールのみ。

## 前提条件

- [開発者ポータル](https://portal.startpinch.com/dashboard/developers) から取得したPinch APIキー
- 音声ファイル（WAV、MP3、FLAC、OGG、M4A、AAC、WMA）または動画ファイル（MP4、MOV、MKV、WebM、AVI） — または公開URL

## クイック例

```
# 1. URLから吹替ジョブを作成
curl -X POST https://api.startpinch.com/api/dubbing/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://example.com/video.mp4",
    "source_lang": "auto",
    "target_lang": "ja"
  }'

# レスポンス: { "job_id": "abc-123", "status": "pending", ... }

# 2. 完了をポーリング
curl https://api.startpinch.com/api/dubbing/jobs/abc-123 \
  -H "Authorization: Bearer YOUR_API_KEY"

# 3. ステータスが "completed" になったら結果をダウンロード
curl https://api.startpinch.com/api/dubbing/jobs/abc-123/result \
  -H "Authorization: Bearer YOUR_API_KEY"

# レスポンス: { "download_url": "https://...", "expires_at": "..." }
```

## ローカルファイルのアップロード

ファイルが公開アクセスできない場合、まずアップロードします：

```
# 1. プリサインドアップロードURLを取得
curl -X POST https://api.startpinch.com/api/dubbing/upload-url \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename": "my-video.mp4", "content_type": "video/mp4"}'

# レスポンス: { "upload_url": "https://...", "source_url": "https://..." }

# 2. S3に直接アップロード
curl -X PUT "UPLOAD_URL_FROM_STEP_1" \
  -H "Content-Type: video/mp4" \
  --data-binary @my-video.mp4

# 3. ステップ1のsource_urlを使用して吹替ジョブを作成
curl -X POST https://api.startpinch.com/api/dubbing/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "SOURCE_URL_FROM_STEP_1",
    "target_lang": "ja"
  }'
```

## ジョブのライフサイクル

ジョブは以下のステータスを経過します：

```
pending → downloading → processing → uploading → completed
                                                → failed
```

`GET /api/dubbing/jobs/{id}` をポーリングして進捗を追跡します。一般的な処理時間は入力1分あたり2〜5分です。

## 料金と制限

|  |  |
| --- | --- |
| **料金** | 入力メディア1分あたり$0.50 |
| **最大再生時間** | 10分 |
| **最小再生時間** | 1秒 |
| **最大ファイルサイズ** | 500 MB |
| **入力形式** | 動画: MP4, MOV, MKV, WebM, AVI; 音声: WAV, MP3, FLAC, OGG, M4A, AAC, WMA |
| **出力形式** | 動画入力: MP4 (H.264 + AAC); 音声入力: MP3またはWAV |
| **レート制限** | 1分あたり10ジョブ |
| **出力有効期限** | ダウンロードURLは48時間後に期限切れ |

## 対応言語

| コード | 言語 |
| --- | --- |
| `en` | 英語 |
| `es` | スペイン語 |
| `fr` | フランス語 |
| `de` | ドイツ語 |
| `it` | イタリア語 |
| `pt` | ポルトガル語 |
| `ru` | ロシア語 |
| `ja` | 日本語 |
| `ko` | 韓国語 |
| `zh` | 中国語 |

## 次のステップ

- [Dubbing API Reference](/content/docs/dubbing-api/index.html) — 完全なエンドポイントドキュメント
- [吹替ダッシュボード](https://portal.startpinch.com/dashboard/dubbing) — ブラウザから音声・動画を吹替
- [Pythonチュートリアル](/content/guides/how-to-dub-videos-with-python/index.html) — バッチ処理付きの完全なPythonガイド