GET /api/actor/{ :id }/versions

Retrieve character’s model versions and predefined emotions

Caution

Except for latest alias model, the model may be unstable or slow.

Request

Headers

Parameters

  • None

Example with cURL 
    curl --request GET \
        --url https://typecast.ai/api/actor/${24-letters-your_actor_id}/versions \
        --header "Content-Type: application/json" \
        --header "Authorization: Bearer $API_TOKEN"

Response

Status Code

status code

value

401

Authorization Error

200

JSON Object that has result, version list(JSON Array)

Element of result consists of followings

key

description

name

name of a model version.

aliases

alias name of the model version.

display_name

used as the model_version in the POST /api/speak endpoint.

emotion_tone_presets

all emotions of the actor for the model version.

first is the first-time model of the actor.

latest is the last-time model of the actor.

emotion_prompt

a flag that emotion_prompt module is activated or not.
Example 
{
  "result": [
      {
          "name": "v1",
          "aliases": [
              "first"
          ],
          "display_name": "CATS",
          "emotion_tone_presets": [
              "happy-1",
              "happy-2",
              "happy-3",
              "0",
              "normal-1"
          ],
          "emotion_prompt": false
      },
      {
          "name": "v2",
          "aliases": [],
          "display_name": "CATS",
          "emotion_tone_presets": [
              "happy-1",
              "happy-2",
              "happy-3",
              "0",
              "normal-1"
          ],
          "emotion_prompt": false
      },
      {
          "name": "v3",
          "aliases": [
            "latest"
          ],
          "display_name": "SSFM-V2.0",
          "emotion_tone_presets": [
              "happy-1",
              "happy-2",
              "happy-3",
              "0",
              "normal-1"
          ],
          "emotion_prompt": true
      }
  ]
}