List interpretation projects

Page through the Interpretation projects owned by your account.

GET /sound_clone/api/v1/interpretation/projects

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/interpretation/projects?page=1&pageSize=20' \
--header 'accessKey: <your_api_key>'

200 Success

{
  "code": 1,
  "message": "success",
  "data": {
    "page": 1,
    "pageSize": 20,
    "total": 1,
    "totalPage": 1,
    "list": [
      {
        "projectId": "ip_...",
        "name": "Launch video ES/FR",
        "state": "PROCESSING",
        "summaryState": "PARTIAL_READY",
        "sourceDurationMs": "90000",
        "targetLanguageCount": 2,
        "readyTargetCount": 1,
        "updatedAt": "2027-01-15T15:56:40"
      }
    ],
    "requestId": "..."
  }
}

Header

accessKey · string · required

API key for authentication.

Query

page · number · required

Page number, >= 1.

pageSize · number · required

Page size: 10, 20 or 50.

Response

page · number

Echoed page number.

pageSize · number

Echoed page size.

total · number

Total number of projects.

totalPage · number

Total number of pages.

list · array

Entries shaped { projectId, name, state, summaryState, sourceDurationMs, targetLanguageCount, readyTargetCount, updatedAt }. sourceDurationMs is a string.

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/interpretation/projects?page=1&pageSize=20' \
--header 'accessKey: <your_api_key>'

200 Success

{
  "code": 1,
  "message": "success",
  "data": {
    "page": 1,
    "pageSize": 20,
    "total": 1,
    "totalPage": 1,
    "list": [
      {
        "projectId": "ip_...",
        "name": "Launch video ES/FR",
        "state": "PROCESSING",
        "summaryState": "PARTIAL_READY",
        "sourceDurationMs": "90000",
        "targetLanguageCount": 2,
        "readyTargetCount": 1,
        "updatedAt": "2027-01-15T15:56:40"
      }
    ],
    "requestId": "..."
  }
}

summaryState is a rolled-up statistic and deliberately does not overstate progress: PARTIAL_READY means some target languages are ready and some are not.

Common errors

• code = 47101: page is below 1, or pageSize is not 10, 20 or 50.