> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.voicecheap.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Projekt erstellen

> Laden Sie eine Video- oder Audiodatei hoch und erstellen Sie ein Projekt, ohne die Übersetzung zu starten

# Projekt erstellen

Erstellen Sie ein neues Projekt durch Hochladen einer Video- oder Audiodatei. Die API startet nur die Transkription (keine Übersetzung oder Lippensynchronisation). Sie können das Projekt später in der VoiceCheap-App öffnen, um die Übersetzung auszulösen, oder [Projektdetails abrufen](https://api-docs.voicecheap.ai/docs/de/api-reference/project-details.md) verwenden, um den Projektstatus zu überprüfen.

## Gleichzeitigkeitslimit

Projekterstellung, Übersetzung und Vertonung prüfen alle das Limit Ihres Kontos für aktive Übersetzungen (höchstens 10, möglicherweise weniger). Nur laufende Übersetzungs- oder Vertonungsvorgänge belegen Plätze; Projekte mit reiner Transkription nicht. Bei Erreichen des Limits gibt die API `CONCURRENT_TRANSLATION_LIMIT_REACHED` (HTTP 429) zurück. Das geltende Limit steht in `details.limit`.

## Anfrage

Dieser Endpunkt akzeptiert `multipart/form-data` mit einem Datei-Upload.

### Header

**x-api-key** `string` *required*

Ihr VoiceCheap API-Schlüssel. Holen Sie sich einen von [app.voicecheap.ai/page-api](https://app.voicecheap.ai/page-api).

### Hauptparameter

**file** `file` *required*

Die hochzuladende Video- oder Audiodatei.

**Unterstützte Videoformate:** `video/mp4`, `video/quicktime`, `video/x-matroska`, `video/webm`, `video/mpeg`

**Unterstützte Audioformate:** `audio/mpeg`, `audio/wav`, `audio/mp4`, `audio/x-m4a`, `audio/flac`, `audio/ogg`, `audio/aac`, `audio/webm`

**Maximale Dateigröße nach Plan:** Beginner 5 GB, Starter 10 GB, Creator 20 GB, Pro 30 GB, Scale 40 GB und Enterprise 60 GB.

**targetLanguage** `string` *required*

Die Zielsprache, die mit diesem Projekt verknüpft werden soll. Muss kleingeschrieben sein.

**Zulässige Werte (70+):** `afrikaans`, `albanian`, `amharic`, `arabic`, `armenian`, `assamese`, `azerbaijani`, `basque`, `belarusian`, `bengali`, `bosnian`, `bulgarian`, `catalan`, `croatian`, `czech`, `danish`, `dutch`, `english`, `british english`, `estonian`, `finnish`, `french`, `french canadian`, `galician`, `german`, `greek`, `gujarati`, `hebrew`, `hindi`, `hungarian`, `icelandic`, `indonesian`, `irish`, `italian`, `japanese`, `kannada`, `kazakh`, `khmer`, `korean`, `lao`, `latvian`, `lithuanian`, `macedonian`, `malay`, `malayalam`, `mandarin`, `marathi`, `mongolian`, `nepali`, `norwegian`, `persian`, `polish`, `portuguese`, `brazilian portuguese`, `pt_brazil`, `punjabi`, `romanian`, `russian`, `serbian`, `slovak`, `slovenian`, `spanish`, `swahili`, `swedish`, `tagalog`, `tamil`, `telugu`, `thai`, `turkish`, `ukrainian`, `urdu`, `vietnamese`, `welsh`, `yoruba`, `zulu`

**originalLanguage** `string`

Die Quellsprache des Inhalts unter Verwendung von ISO-Sprachcodes (z. B. `en`, `es`, `fr`, `de`, `ja`, `zh`).

> [!WARNING]
>
> **Dringend empfohlen: Lassen Sie dies für die automatische Erkennung leer.**
>
> Geben Sie diesen Parameter nur an, wenn Sie zu 100 % sicher sind, dass der Sprachcode korrekt ist und im gültigen ISO-Format vorliegt. Falsche Sprachcodes führen zu Transkriptionsfehlern. Unsere automatische Erkennung unterstützt über 80 Sprachen und ist hochpräzise.

**Standard:** `auto-detect`

**projectName** `string`

Ein benutzerdefinierter Name für das Projekt. Nützlich zur Identifizierung von Projekten in Ihrem Dashboard.

**Standard:** Die Projekt-ID wird verwendet, falls keine angegeben ist.

**webhookUrl** `string`

Ein https-Endpunkt, der die [Webhook-Ereignisse](https://api-docs.voicecheap.ai/docs/de/api-reference/webhooks.md) für dieses Projekt empfängt,
und den für Ihr Konto konfigurierten Endpunkt überschreibt.

**Standard:** Der Webhook-Endpunkt des Kontos, sofern einer konfiguriert ist.

**numberOfSpeakers** `string`

`auto-detect` oder eine Ganzzahl von `1` bis `32`. Die Angabe der bekannten Sprecheranzahl kann die Diarisierung verbessern.

**Standard:** `auto-detect`

**brandVocabulary** `string`

Ein JSON-String-Array mit anfragespezifischen Namen, Marken, Akronymen oder Fachbegriffen. Diese Begriffe werden mit dem gespeicherten Konto- oder Team-Glossar zusammengeführt.

```json theme={null}
["VoiceCheap", "SmartSync", "ITC Global"]
```

**removeFillerWords** `boolean`

Entfernen Sie häufige Füllwörter während der Transkription.

**Standard:** `true`

**sourceSrt** `string`

Ein vorhandenes SRT-Transkript in der Quellsprache. Wenn dies bereitgestellt wird, muss `originalLanguage` ein expliziter Sprachcode anstelle von `auto-detect` sein.

Dieser Endpunkt dient nur der Projekterstellung und dem Start der Transkription. Übersetzungsoptionen wie Untertitel, Stimmklonen und Hintergrundaudio werden von `POST /v1/translate` gehandhabt.

## Beispielanfrage

```bash theme={null}
curl -X POST "https://api.voicecheap.ai/v1/projects" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "file=@/path/to/video.mp4" \
  -F "targetLanguage=french" \
  -F "projectName=Launch Demo" \
  -F "numberOfSpeakers=2" \
  -F 'brandVocabulary=["VoiceCheap","SmartSync"]' \
  -F "removeFillerWords=true"
```

## Beispielantwort

```json theme={null}
{
  "success": true,
  "message": "Project created. Transcription started.",
  "projectId": "project_123",
  "projectName": "Launch Demo",
  "targetLanguage": "french",
  "status": "processing"
}
```

## Fehler

| Status | Code | Beschreibung |
| - | - | - |
| 400 | `FILE_REQUIRED` | Es wurde keine Datei mit der Anfrage hochgeladen |
| 400 | `INVALID_FILE_TYPE` | Der hochgeladene Dateityp wird nicht unterstützt |
| 400 | `DURATION_DETECTION_FAILED` | Die Dauer der hochgeladenen Datei konnte nicht erkannt werden |
| 400 | `INVALID_MULTIPART_REQUEST` | Multipart-Formulardaten sind fehlerhaft oder überschreiten die Feldgrenzen |
| 400 | `INVALID_BRAND_VOCABULARY` | Ein anfragespezifischer Glossar-Eintrag ist ungültig |
| 400 | `INVALID_SOURCE_SRT` | Die bereitgestellte Quell-SRT ist fehlerhaft |
| 400 | `SOURCE_LANGUAGE_REQUIRED_FOR_SRT` | sourceSrt erfordert eine explizite originalLanguage |
| 400 | `VIDEO_TOO_LONG` | Die Mediendauer überschreitet das Limit Ihres Tarifs |
| 413 | `FILE_TOO_LARGE` | Die hochgeladene Datei überschreitet das Limit Ihres Tarifs |
| 401 | `MISSING_API_KEY` | API-Schlüssel ist erforderlich |
| 401 | `INVALID_API_KEY_FORMAT` | Der API-Schlüssel muss mit `vc_` beginnen |
| 401 | `INVALID_API_KEY` | Der bereitgestellte API-Schlüssel ist ungültig |
| 403 | `SUBSCRIPTION_REQUIRED` | API-Zugriff erfordert einen Starter-Plan oder höher |
| 429 | `RATE_LIMIT_EXCEEDED` | Zu viele Anfragen (Limit: 10 Anfragen pro Minute) |
| 429 | `CONCURRENT_TRANSLATION_LIMIT_REACHED` | Kontolimit für gleichzeitige Übersetzungen erreicht; siehe `details.limit` |
| 500 | `INTERNAL_ERROR` | Unerwarteter Serverfehler |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.