Skip to main content
创建项目

创建项目

通过上传视频或音频文件创建新项目。API 仅启动转录(不进行翻译或口型同步)。您可以稍后在 VoiceCheap 应用中打开该项目以触发翻译,或使用 获取项目详情 检查项目状态。

并发限制

此端点与 POST /v1/translate 共享相同的并发限制:每个账户最多 10 个正在进行的翻译。如果达到限制,请求将返回 CONCURRENT_TRANSLATION_LIMIT_REACHED (HTTP 429)。

请求

此端点接受带有文件上传的 multipart/form-data

标头

string
必填
您的 VoiceCheap API 密钥。从 app.voicecheap.ai/page-api 获取一个。

正文参数

file
必填
要上传的视频或音频文件。支持的视频格式: video/mp4video/quicktimevideo/x-matroskavideo/webmvideo/mpeg支持的音频格式: audio/mpegaudio/wavaudio/mp4audio/x-m4aaudio/flacaudio/oggaudio/aacaudio/webm按计划划分的最大文件大小: Beginner 5 GB、Starter 10 GB、Creator 20 GB、Pro 30 GB、Scale 40 GB 和 Enterprise 60 GB。
string
必填
与此项目关联的目标语言。必须为小写。允许的值 (70+): afrikaansalbanianamharicarabicarmenianassameseazerbaijanibasquebelarusianbengalibosnianbulgariancatalancroatianczechdanishdutchenglishbritish englishestonianfinnishfrenchfrench canadiangaliciangermangreekgujaratihebrewhindihungarianicelandicindonesianirishitalianjapanesekannadakazakhkhmerkoreanlaolatvianlithuanianmacedonianmalaymalayalammandarinmarathimongoliannepalinorwegianpersianpolishportuguesebrazilian portuguesepunjabiromanianrussianserbianslovakslovenianspanishswahiliswedishtagalogtamilteluguthaiturkishukrainianurduvietnamesewelshyorubazulu
string
使用 ISO 语言代码的内容源语言(例如 enesfrdejazh)。
强烈建议:留空以进行自动检测。仅在您 100% 确定语言代码正确且为有效 ISO 格式时才提供此参数。错误的语言代码会导致转录失败。我们的自动检测支持 80 多种语言,且非常准确。
默认值: auto-detect
string
项目的自定义名称。有助于在您的仪表板中识别项目。默认值: 如果未提供,将使用项目 ID。
string
一个接收此项目 webhook 事件 的 https 端点, 覆盖您账户上配置的端点。默认值: 配置账户 webhook 端点时,使用该端点。
string
auto-detect 或从 132 的整数。提供已知的说话人数量可以改善说话人日志记录。默认值: auto-detect
string
一个包含特定于请求的名称、品牌、首字母缩略词或专业术语的 JSON 字符串数组。这些术语将与保存的账户或团队词汇表合并。
boolean
在转录过程中删除常见的填充词。默认值: true
string
现有的源语言 SRT 转录。提供时,originalLanguage 必须是明确的语言代码,而不是 auto-detect
此端点仅用于项目创建 + 转录启动。字幕、语音克隆、语音隔离和背景音乐等翻译选项由 POST /v1/translate 处理。

请求示例

响应示例

错误