sangtao.ai
API key

Characters

Delete a character

Delete a character and its reference images.

DELETEhttps://api.sangtao.ai/v2/characters/{id}

Authorization

  • X-Api-Keystring · headerrequired

    Your API key, from the API keys page of your account.

Path parameters

  • idstringrequired

    The ID in the path.

Deletes the character and its reference images. Videos already made are not affected. A Video Studio project that still uses this character treats it as not there.

Response

data is { "deleted": true }.

Errors

StatuserrorCodeWhen
404CHARACTER_NOT_FOUNDNo such character, or it is not yours

An error has success: false, errorCode as above, and error is a sentence saying what went wrong.

DELETE/characters/{id}
curl -X DELETE "https://api.sangtao.ai/v2/characters/ch_3kT9qPz0B" \
  -H "X-Api-Key: YOUR_API_KEY"
{
  "success": true,
  "data": {
    "deleted": true
  }
}