Character Studio 3D

Customize a library character from a text request

Cost: 2 credits (refunded on technical failure). Creates a rigged GLB with all animations plus 4 preview views. Poll GET /character-studio/characters/:id until status=completed. Pass fromModelId to iterate on a previous customization.

post/v1/character-studio/characters

Request

  • Base URL: https://api.sprixen.com
  • URL: https://api.sprixen.com/v1/character-studio/characters
  • Auth: bearer (a scheme the document does not define)

Request body

baseSlugstring required

Slug of the base library character (see GET /v1/character-studio/library), e.g. "knight". When fromModelId is set it must match the base of that model.

promptstring required

Free-text request describing the customization (colors, weapons, accessories, glow, hat...). The planner turns it into structured edit ops. With fromModelId it is applied on top of that customization.

namestring

Human-readable name. Defaults to the base character name plus the start of the prompt.

projectIdstring

Project to associate the character with (must belong to you).

fromModelIdstring

Iterate on a previous customization: ID of one of your completed Character Studio models. Its edit ops are used as the starting point and the new prompt is applied on top.

Example request

{
  "baseSlug": "knight",
  "prompt": "Make it a crimson fire knight: red armor with glowing orange accents, hold the one-handed axe and the round shield",
  "name": "Fire Knight",
  "projectId": "cld1234...",
  "fromModelId": "cld5678..."
}

Response

Customization queued (pending)

Changes

No recorded changes to this operation across all 1 revision of this API.