sangtao.ai
API key

Characters

Create a character

Create a character, to keep the same look across scenes and videos.

POSThttps://api.sangtao.ai/v2/characters

Authorization

  • X-Api-Keystring · headerrequired

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

Body

  • namestringrequired

    Up to 100 characters

  • appearanceDescriptionstring

    Up to 1,000 characters

  • biographystring

    Up to 2,000 characters

  • aliasesstring

    Up to 200 characters

Response

The Character just created, with no images yet. Add images with the two reference image endpoints: Upload a reference image, or Add an image from a link.

Errors

StatuserrorCodeWhen
400VALIDATION_ERRORInvalid data — name missing, or a field over its limit

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

POST/characters
curl -X POST "https://api.sangtao.ai/v2/characters" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mèo Mướp",
    "appearanceDescription": "orange tabby cat, chubby body",
    "aliases": "Mướp, Bé Mướp"
  }'
{
  "success": true,
  "data": {
    "id": "ch_3kT9qPz0B",
    "name": "Mèo Mướp",
    "appearanceDescription": "orange tabby cat, chubby body",
    "biography": null,
    "aliases": "Mướp, Bé Mướp",
    "publishStatus": null,
    "createdAt": "2026-11-08T09:12:44Z",
    "updatedAt": "2026-11-08T09:12:44Z",
    "refImages": []
  }
}