Pinch PINCH

吹替クイックスタート

この文書は英語版 Dubbing Quickstart の日本語訳です。最終同期: 2026年3月17日。

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

前提条件

  • 開発者ポータルから取得した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中国語

次のステップ