Venice API Docs: /characters

GET

characters

curl --request GET \
  --url https://api.venice.ai/api/v1/characters \
  --header 'Authorization: Bearer <token>'

{
  "object": "list",
  "data": [
    {
      "name": "Alan Watts",
      "description": "Alan Watts (6 January 1915 – 16 November 1973) was a British and American writer, speaker, and self-styled \"philosophical entertainer\", known for interpreting and popularizing Buddhist, Taoist, and Hindu philosophy for a Western audience.",
      "slug": "alan-watts",
      "shareUrl": "https://venice.ai/c/alan-watts",
      "createdAt": "2024-12-20T21:28:08.934Z",
      "updatedAt": "2025-02-09T03:23:53.708Z",
      "webEnabled": true,
      "adult": false,
      "tags": [
        "AlanWatts",
        "Philosophy",
        "Buddhism",
        "Taoist",
        "Hindu"
      ],
      "stats": {
        "imports": 112
      }
    }
  ]
}

Experimental Endpoint

This is an experimental endpoint and may be subject to change.

Postman Collection

For additional examples, please see this Postman Collection.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

200

application/json

object

enum<string>

required

Available options:

list

data

object[]

required

data.name

string

required

Name of the character

Example:

"Alan Watts"

data.description

string | null

required

Description of the character

Example:

"Alan Watts (6 January 1915 – 16 November 1973) was a British and American writer, speaker, and self-styled \"philosophical entertainer\", known for interpreting and popularizing Buddhist, Taoist, and Hindu philosophy for a Western audience."

data.slug

string

required

Slug of the character to be used in the completions API

Example:

"alan-watts"

Share URL of the character

Example:

"https://venice.ai/c/alan-watts"

data.createdAt

string

required

Date when the character was created

Example:

"2024-12-20T21:28:08.934Z"

data.updatedAt

string

required

Date when the character was last updated

Example:

"2025-02-09T03:23:53.708Z"

data.webEnabled

boolean

required

Whether the character is enabled for web use

Example:

true

data.adult

boolean

required

Whether the character is considered adult content

Example:

false

data.tags

string[]

required

Tags associated with the character

Example:

[
  "AlanWatts",
  "Philosophy",
  "Buddhism",
  "Taoist",
  "Hindu"
]

data.stats

object

required

Suggest edits Raise issue

Rate Limit Logs

curl --request GET \
  --url https://api.venice.ai/api/v1/characters \
  --header 'Authorization: Bearer <token>'

{
  "object": "list",
  "data": [
    {
      "name": "Alan Watts",
      "description": "Alan Watts (6 January 1915 – 16 November 1973) was a British and American writer, speaker, and self-styled \"philosophical entertainer\", known for interpreting and popularizing Buddhist, Taoist, and Hindu philosophy for a Western audience.",
      "slug": "alan-watts",
      "shareUrl": "https://venice.ai/c/alan-watts",
      "createdAt": "2024-12-20T21:28:08.934Z",
      "updatedAt": "2025-02-09T03:23:53.708Z",
      "webEnabled": true,
      "adult": false,
      "tags": [
        "AlanWatts",
        "Philosophy",
        "Buddhism",
        "Taoist",
        "Hindu"
      ],
      "stats": {
        "imports": 112
      }
    }
  ]
}

Venice APIs

List Characters

Experimental Endpoint

Postman Collection

Authorizations

Response

Venice APIs

​Experimental Endpoint

​Postman Collection

Authorizations

Response

Experimental Endpoint

Postman Collection