Create an interpretation project

Create an Interpretation project. The project starts empty; upload a source next.

POST /sound_clone/api/v1/interpretation/projects

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/interpretation/projects' \
--header 'accessKey: <your_api_key>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: 0d2b7c3a91f54b62' \
--data '{
  "name": "Launch video ES/FR",
  "targetLanguages": ["es", "fr"]
}'

200 Success

{
  "code": 1,
  "message": "success",
  "data": {
    "projectId": "ip_...",
    "state": "DRAFT",
    "settingsVersion": 1,
    "requestId": "..."
  }
}

Creates an empty project whose state is DRAFT. It does not start any processing — you set the draft, then upload a source.

Header

accessKey · string · required

API key for authentication.

Idempotency-Key · string · required

Unique per operation: 16–64 printable ASCII characters. Same key with the same body replays safely; same key with a different body is rejected with 47111.

Body

name · string · required

Project name: non-empty after trimming, at most 120 code points.

sourceLanguage · string

Optional. null, an empty string or AUTO means automatic detection; otherwise a language key from capabilities.languages.

targetLanguages · array

Optional initial target languages. May be empty; the selection can be changed later with PATCH /draft.

Response

projectId · string

Stable project identifier.

state · string

DRAFT right after creation.

settingsVersion · number

The current draft version. Pass it as expectedVersion / settingsVersion in later calls to detect concurrent changes.

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/interpretation/projects' \
--header 'accessKey: <your_api_key>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: 0d2b7c3a91f54b62' \
--data '{
  "name": "Launch video ES/FR",
  "targetLanguages": ["es", "fr"]
}'

200 Success

{
  "code": 1,
  "message": "success",
  "data": {
    "projectId": "ip_...",
    "state": "DRAFT",
    "settingsVersion": 1,
    "requestId": "..."
  }
}

A replay re-reads the current project; the response may reflect later state than the first call. Keep projectId as the anchor.

Common errors

• code = 47101: the name is missing, empty or too long.
• code = 47111: the Idempotency-Key was reused with a different body.
• code = 47122: temporarily unavailable — retry with backoff.