venice-characters
Character endpoints and `character_slug` usage
Developer Setup
Setup & Installation
npx skills add https://github.com/veniceai/skills --skill venice-charactersnpx skills add https://github.com/veniceai/skills --skill venice-charactersOverview
What This Skill Does
Character endpoints and `character_slug` usage
Application
When to use this Skill
- Configuring integration settings for custom agent workflows.
- Optimizing query execution and response latency in production.
- Developing clean, standard-compliant implementations for enterprise services.
- Troubleshooting connection timeouts and authentication handshakes.
- Monitoring API rate limits and execution pipelines programmatically.
Documentation
Show Skills.md file
Venice Characters
Characters are published personas on Venice — each one bundles a system prompt, a backing model, optional web access, and metadata (tags, ratings, adult flag). You apply a character to any chat by passing its slug via venice_parameters.character_slug.
Use when
- You want to build a character-selection UI or discovery surface.
- You want to ship an app with a preset persona (e.g. a coding coach, a philosopher, a game NPC).
- You need to adapt a character's underlying model (
modelId) to match your capability requirements.
Three endpoints, all under Preview (API may change):
| Endpoint | Purpose |
|---|---|
GET /characters |
Browse/search/filter the catalog. |
GET /characters/{slug} |
Fetch one character. |
GET /characters/{slug}/reviews |
Paginated public reviews. |
All three endpoints require authentication (Bearer API key or x402 SIWE) — see venice-auth. There is no unauthenticated public endpoint.
GET /characters
curl "https://api.venice.ai/api/v1/characters?search=philosopher&sortBy=highestRating&limit=20" \
-H "Authorization: Bearer $VENICE_API_KEY"
Recommendations
Explore other random skills
apollo-federation
Write Apollo Federation 2 subgraph schemas and compose them into a supergraph
apollo-kotlin
A GraphQL client for Android, JVM, and Kotlin Multiplatform projects
apollo-mcp-server
Connect AI agents to GraphQL APIs through the Model Context Protocol