302.AI Translation, Dubbing, and Speech Recognition Channel
What is it?
302.AI is an AI aggregation service platform that provides unified API access to a variety of AI models. In pyVideoTrans, 302.AI can serve as a translation channel, dubbing channel, and speech recognition channel all at once.
- Translation: Supports ChatGPT-4o, Gemini, and other models
- Dubbing: Supports hundreds of voices from Azure, Doubao (豆包), MiniMaxi, DubbingX, and OpenAI
- Speech recognition: Supports speech-to-text via OpenAI's speech recognition API
Prerequisites
- pyVideoTrans v2.10 or higher
- A 302.AI platform account (to obtain an API key)
Getting an API Key
Step 1: Log in to 302.AI
Go to https://www.302.ai and register/log in to your account.
Step 2: Create an API Key
- After logging in, click "API Marketplace" → "API Management" in the left sidebar
- Enter a name in the "API Name" field, then click the "Add API" button at the bottom
- Scroll down and click the eye icon next to the created API to reveal the full API key, then copy it
Configuring Translation in pyVideoTrans
- Upgrade pyVideoTrans to v2.10+
- Click Settings in the top-left corner → 302.AI Translation
- Enter the API key you just created
- In the settings panel, select a model for subtitle translation, such as
chatgpt-4oorgemini-2.0-flash - On the main interface, select 302.AI from the Translation Channel dropdown
Dubbing Voice Configuration
Through 302.AI, you can use dubbing voices from the following platforms:
OpenAI Voices
| Voice Name | ID |
|---|---|
| Alloy | alloy |
| Ash | ash |
| Ballad | ballad |
| Coral | coral |
| Echo | echo |
| Fable | fable |
| Onyx | onyx |
| Nova | nova |
| Sage | sage |
| Shimmer | shimmer |
| Verse | verse |
Doubao (豆包) Voices (partial)
| Voice Name | ID |
|---|---|
| Beijing XiaoYe (multi-emotion) | zh_male_beijingxiaoye_emo_v2_mars_bigtts |
| Gentle Girlfriend (multi-emotion) | zh_female_roumeinvyou_emo_v2_mars_bigtts |
| Sunny Youth (multi-emotion) | zh_male_yangguangqingnian_emo_v2_mars_bigtts |
| CanCan / Shiny | zh_female_cancan_mars_bigtts |
| Fresh Female Voice | zh_female_qingxinnvsheng_mars_bigtts |
| Intellectual Female Voice | zh_female_zhixingnvsheng_mars_bigtts |
| Gentle Xiaoya | zh_female_wenrouxiaoya_moon_bigtts |
| Magnetic Male Narrator / Morgan | zh_male_jieshuonansheng_mars_bigtts |
MiniMaxi Voices (partial)
| Voice Name | ID |
|---|---|
| Youthful Male Voice | male-qn-qingse |
| Elite Male Voice | male-qn-jingying |
| Young Girl Voice | female-shaonv |
| Mature Female Voice | female-yujie |
| Male Presenter | presenter_male |
| Female Presenter | presenter_female |
DubbingX Voices (partial)
| Voice Name | ID |
|---|---|
| MuJin (young girl, energetic, bright) | 30149 |
| MaoMao (pleasant, magnetic, textured) | 30136 |
| BaoBao (young, sweet, pleasant) | 30131 |
| XiaoLiangGe (mature, warm) | 30002 |
Recommended Configuration
| Setting | Recommended Value |
|---|---|
| API Key | Obtained from 302.AI platform |
| Translation Model | chatgpt-4o or gemini-2.0-flash |
| Dubbing Voice | Choose from OpenAI/Doubao/MiniMaxi/DubbingX voices as needed |
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
| API key invalid | Key copied incompletely | Click the eye icon again and copy the full key |
| Translation error | Incorrect model selected | Verify the model is available on the 302.AI platform |
| Dubbing produces no sound | Voice ID incorrect | Refer to the voice table above for the correct ID |
| Insufficient balance | API key credits exhausted | Top up on the 302.AI platform |