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

Retrieve predefined emotions of a character for the specified version.

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/{name-or-alias-of-model-version} \
        --header "Content-Type: application/json" \
        --header "Authorization: Bearer $API_TOKEN"

Response

Status Code

status code

value

401

Authorization Error

404

Version not found Error

200

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

result consists of followings

key

description

name

name of a model version.

aliases

alias name of the model version.

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"
      ],
      "emotion_tone_presets": [
          "happy-1",
          "happy-2",
          "happy-3",
          "0",
          "normal-1"
      ],
      "emotion_prompt": false
  }
}