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": "zh"
  }'

# 响应: { "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": "zh"
  }'

任务生命周期

任务经历以下状态：

pending → downloading → processing → uploading → completed
                                                → failed

轮询 GET /api/dubbing/jobs/{id} 跟踪进度。典型处理时间为每分钟输入2-5分钟。

价格和限制

价格每分钟输入媒体$0.50
最大时长10分钟
最小时长1秒
最大文件大小500 MB
输入格式视频: MP4, MOV, MKV, WebM, AVI; 音频: WAV, MP3, FLAC, OGG, M4A, AAC, WMA
输出格式视频输入: MP4 (H.264 + AAC); 音频输入: MP3或WAV
速率限制每分钟10个任务
输出过期下载URL在48小时后过期

支持的语言

代码语言
en英语
es西班牙语
fr法语
de德语
it意大利语
pt葡萄牙语
ru俄语
ja日语
ko韩语
zh中文

下一步