Skip to main content
Characters are public personas that you can apply to a chat completion. Each character has a slug and an associated text model.
The Characters API is in preview and may change.

Discover a Character

Use the List Characters endpoint to search and filter the public catalog:
cURL
The response contains the values needed for chat completions:
You can also retrieve one character by slug with the Get Character endpoint:
cURL
Use the returned slug as venice_parameters.character_slug. Use its modelId as the chat completion model, or choose a compatible model from the Text Models page.

Chat with the Character

Pass character_slug in venice_parameters when calling the OpenAI-compatible Chat Completions API:
Character slugs apply only to public Venice characters. A missing or invalid slug returns an API error.