用途:帮助构建、迁移和调试与 Venice.ai API 的集成。基础地址为 https://api.venice.ai/api/v1,提供 OpenAI 兼容面(聊天补全、嵌入、图像生成、TTS、转写、模型列表)以及图像、异步媒体、文档解析、搜索、账号管理、钱包支付和加密 RPC 等原生端点。
主要能力:文本与推理、工具调用、多模态与文件输入;图像生成、编辑、多图编辑、放大、去背景;语音合成、声音克隆句柄、转写;音乐与视频的异步报价/排队/获取/完成;文档文本抽取、URL 抓取、结构化搜索;模型目录与 traits 解析;API Key、账单与用量查询;x402/SIWX 钱包支付。
使用方式:认证二选一,Bearer API key 用 Authorization: Bearer $VENICE_API_KEY,或 x402/SIWX 钱包用 SIGN-IN-WITH-X 头。任务开始先做发现,例如 curl -sS "https://api.venice.ai/api/v1/models?type=text" -H "Authorization: Bearer $VENICE_API_KEY",以及 /models/traits。可用辅助脚本:python scripts/discover_models.py --type text。异步音视频遵循 quote -> queue -> retrieve -> complete,全程使用同一模型 ID 和 queue_id(非旧字段 queueid)。工具调用需先确认 supportsFunctionCalling,并回传工具结果。
适用场景:需要按实时模型元数据选择模型、处理多模态输入、生成音视频媒体、接入搜索增强或钱包计费的集成开发。
限制:不得猜测模型 ID、价格、声音、尺寸、时长、上下文与速率限制,须查询实时端点。Traits 用于自动升级,固定 ID 用于可复现性,启动时解析并短暂缓存。Alpha/Beta/Preview 与实验端点不稳定,须以当前 OpenAPI 为准。不要暴露凭据或钱包私钥,不要将 API Key 放入浏览器包、日志、提示词或代码库。仅对瞬时失败重试并遵守 Retry-After;400/401/403/415/422 等不应原样重试。其它细节暂未提供。