AI Generation

Create workspace character

Changed on

Creates a reusable character from existing workspace image asset IDs.

post/characters

Request

  • Base URL: https://blitzreels.com/api/v1
  • URL: https://blitzreels.com/api/v1/characters
  • Auth: API key in header Authorization

Headers

Idempotency-Keystring

Retry key (8-200 characters). Reusing it with identical input returns the original response; different input returns 409.

Idempotency-Keystring

Retry key (8-200 characters). Reusing it with identical input returns the original response; different input returns 409.

Request body

namestring required
type'human' | 'fictional' | 'other'
consistency_mode'reference' | 'trained_lora'
speciesstring nullable
canonical_descriptionstring nullable
story_factsstring[]
default_voice_idstring nullable
default_voice_stylestring nullable
reference_asset_idsstring[]
primary_reference_asset_idstring uuid nullable

Response

Successful response

idstring uuid required
namestring required
type'human' | 'fictional' | 'other' required
status'draft' | 'ready' | 'training' | 'failed' | 'archived' required
consistency_mode'reference' | 'trained_lora' required
speciesstring nullable required
canonical_descriptionstring nullable required
story_factsstring[] required
default_voice_idstring nullable required
default_voice_stylestring nullable required
folder_idstring uuid nullable required
primary_reference_asset_idstring uuid nullable required
created_atstring required
updated_atstring required

Changes

  • 35608b12471dRevision changes
    • warning

      deleted the header request parameter Idempotency-Key

    • info

      added the new optional header request parameter Idempotency-Key