SpicyAPIspicyAPI
Characters

Delete Character View

Remove a body view from a character. The image stays in your library.

DELETE/v1/characters/{id}/views/{view_id}Try it
Delete Character View
cURL
curl --request DELETE \
  --url https://api.spicyapi.com/v1/characters/chr_9f2a1c3b7d4e5a60/views/cv_3b1f9a20c4d7 \
  --header 'Authorization: Bearer $SPICYAPI_KEY'
200
JSON
{ "id": "chr_9f2a1c3b7d4e5a60", "object": "character", "name": "Mara", "views": [], "status": "active" }

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your SpicyAPI key (sk-spicy-…). Create one in the dashboard under API Keys.

Response

200 · application/json

Character

idstringrequired

Character id, chr_....

namestringrequired

The label you gave.

sheet_urlstring | nullrequired

The rendered reference sheet (also listed in GET /v1/images once the character is active). null while the character is under_review.

source_urlsstring[]required

The images it was built from. Empty while the character is under_review.

descriptionstringrequired

Text descriptor of the person, appended to prompts that use the character.

importedbooleanrequired

true for a character brought in with POST /v1/characters/import.

viewsobject[]required

Body views (id, label, url, and for a cropped view source_url and crop): your own images of this person from other angles, added with POST /v1/characters/{id}/views. Empty while under_review.

statusstringrequired

active, or under_review for an import a person has to approve first. Using an under_review character returns 409.

createdinteger | null

Unix timestamp.

Was this page helpful?

Suggest editsRaise issue
Create Speech