Create an upload session

Start a multipart upload for the project’s source audio or video file.

POST /sound_clone/api/v1/interpretation/projects/{projectId}/uploads

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/interpretation/projects/ip_.../uploads' \
--header 'accessKey: <your_api_key>' \
--header 'Content-Type: application/json' \
--data '{
  "filename": "launch.mp4",
  "size": 18432611,
  "contentType": "video/mp4"
}'

200 Success

{
  "code": 1,
  "message": "success",
  "data": {
    "uploadId": "iu_...",
    "projectId": "ip_...",
    "state": "CREATED",
    "declaredSize": "18432611",
    "partSizeBytes": 16777216,
    "totalParts": 2,
    "expiresAt": "2027-01-16T15:52:11",
    "requestId": "..."
  }
}

Creates a multipart upload session. The service returns the part size and part count; the actual bytes are uploaded directly to object storage.

Header

accessKey · string · required

API key for authentication.

Path

projectId · string · required

The project identifier.

Body

filename · string · required

Original file name, non-empty, at most 512 characters.

size · number · required

Exact byte length of the file. Greater than 0 and not greater than capabilities.maxSourceBytes.

contentType · string

Optional. When omitted or blank the service uses application/octet-stream. At most 128 characters; CR/LF are rejected.

Response

uploadId · string

The upload session identifier. Use it for signing parts, polling status and completing.

projectId · string

Project identifier.

state · string

CREATED right after creation.

declaredSize · string

The declared size, as a string.

partSizeBytes · number

The size of each part, as decided by the service. Use it as returned.

totalParts · number

The number of parts to upload. Use it as returned.

expiresAt · string

When the session expires (24 hours by default).

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/interpretation/projects/ip_.../uploads' \
--header 'accessKey: <your_api_key>' \
--header 'Content-Type: application/json' \
--data '{
  "filename": "launch.mp4",
  "size": 18432611,
  "contentType": "video/mp4"
}'

200 Success

{
  "code": 1,
  "message": "success",
  "data": {
    "uploadId": "iu_...",
    "projectId": "ip_...",
    "state": "CREATED",
    "declaredSize": "18432611",
    "partSizeBytes": 16777216,
    "totalParts": 2,
    "expiresAt": "2027-01-16T15:52:11",
    "requestId": "..."
  }
}

Do not assume a fixed 16 MiB part size or a fixed 3 GiB limit. Read partSizeBytes and totalParts from this response and maxSourceBytes from capabilities.

Common errors

• code = 47125: the file exceeded the size limit, or the declared size is not greater than zero / the request is empty.
• code = 47101: filename is missing or too long, or contentType is invalid.
• code = 47102: the project does not exist or is not owned by your account.
• code = 47127: object storage is unavailable — retry.