360 Secure SkillHub
360 安全技能中心

Venice Characters

通过 Python 脚本调用 Venice AI 接口浏览其角色人格库：支持按名称或描述搜索、按标签过滤、限制结果数量，并以表格、列表或 JSON 输出，可保存到文件。角色信息包含名称、描述、slug、模型、标签与热度统计。需 VENICE_API_KEY 与 uv 运行环境。

sabrinaaquino
sabrinaaquino
热度 51.08
最近更新 2026-03-14 12:27:45
分类：搜索依赖：代码执行 / 第三方 API / 读写文件应用场景：研究 / 推荐

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add venice-characters
Metadata
name
venice-characters
description
Browse Venice AI's character personas library - discover AI characters for roleplay, creative writing, and conversations.
homepage
https://venice.ai
metadata
{"openclaw":{"emoji":"🎭","requires":{"bins":["uv"],"env":["VENICE_API_KEY"]},"primaryEnv":"VENICE_API_KEY","install":[{"id":"uv-brew","kind":"brew","formula":"uv","bins":["uv"],"label":"Install uv (brew)"}]}}

Venice Characters

Browse Venice AI's library of character personas - discover AI characters for roleplay, creative writing, and engaging conversations.

API Base URL: https://api.venice.ai/api/v1 Documentation: docs.venice.ai

Setup

  1. Get your API key from venice.ai → Settings → API Keys
  2. Set the environment variable:
export VENICE_API_KEY="your_api_key_here"

Browse Characters

uv run {baseDir}/scripts/characters.py

Options:

  • --search: Search by name or description
  • --tag: Filter by tag
  • --limit: Max results (default: 20)
  • --format: Output format: table, json, list (default: table)
  • --output: Save to file

Examples

List popular characters:

uv run {baseDir}/scripts/characters.py

Search for a character:

uv run {baseDir}/scripts/characters.py --search "assistant"

Filter by tag:

uv run {baseDir}/scripts/characters.py --tag "creative"

Export to JSON:

uv run {baseDir}/scripts/characters.py --format json --output characters.json

Character Info

Each character includes:

  • Name & Description - Character identity
  • Slug - Unique identifier for API use
  • Model - The LLM powering the character
  • Tags - Categories/themes
  • Stats - Popularity metrics

Using Characters

Characters can be used with Venice's chat completions by specifying the character slug in your prompts or via the Venice web interface.

Runtime Note

This skill uses uv run which automatically installs Python dependencies (httpx) via PEP 723 inline script metadata. No manual Python package installation required - uv handles everything.

API Reference

Endpoint Description Auth
GET /characters List all characters API key
GET /characters/:slug Get character details API key

Full API docs: docs.venice.ai