# 配音快速入门

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

## 快速示例

```bash
# 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": "..." }
```

## 上传本地文件

如果文件不可公开访问，请先上传：

```bash
# 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"
  }'
```

## 任务生命周期

任务经历以下状态：

```bash
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` | 中文 |

## 下一步

- [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指南