简介

​

身份验证

Authorization: Bearer VENICE_API_KEY

​

OpenAI 兼容性

​

设置

curl https://api.venice.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "venice-uncensored",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

​

Venice 专有功能

​

系统 prompt

1. 默认行为：您的系统 prompt 会附加到 Venice 的默认值之后
2. 自定义行为：完全禁用 Venice 的系统 prompt

​

禁用 Venice 系统 prompt

curl https://api.venice.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "venice-uncensored",
    "messages": [
      {"role": "system", "content": "Your custom system prompt"},
      {"role": "user", "content": "Why is the sky blue?"}
    ],
    "venice_parameters": {
      "include_venice_system_prompt": false
    }
  }'

​

Venice 参数

​

Prompt 缓存

​

响应头参考

​

重要说明

• 头部名称大小写：HTTP 头部不区分大小写，但 Venice 为保持一致性使用小写加连字符
• 字符串值：头部中的布尔值以字符串形式返回（"true" 或 "false"）
• 数值：大数字和余额值可能以字符串形式返回，以避免精度丢失
• 可选头部：并非所有头部都会在每个响应中返回；是否存在取决于端点和请求上下文
• 压缩：在请求中使用 Accept-Encoding: gzip, br 以在支持的地方接收压缩响应

​

示例：访问响应头部

// After making an API request, access headers from the response object
const requestId = response.headers.get('CF-RAY');
const remainingRequests = response.headers.get('x-ratelimit-remaining-requests');
const remainingTokens = response.headers.get('x-ratelimit-remaining-tokens');
const usdBalance = response.headers.get('x-venice-balance-usd');

// Check for model deprecation warnings
const deprecationWarning = response.headers.get('x-venice-model-deprecation-warning');
if (deprecationWarning) {
  console.warn(`Model Deprecation: ${deprecationWarning}`);
}

​

最佳实践

1. 速率限制：监控 x-ratelimit-remaining-requests 和 x-ratelimit-remaining-tokens 头部并实现指数退避
2. 余额监控：跟踪 x-venice-balance-usd 和 x-venice-balance-diem 头部以避免服务中断
3. 系统 prompt：在启用和不启用 Venice 系统 prompt 的情况下进行测试，以找到最适合您用例的方式
4. API 密钥：妥善保管 API 密钥并定期轮换
5. 请求日志：记录 CF-RAY 头部值以便与支持团队进行故障排查
6. 模型弃用：使用模型时检查 x-venice-model-deprecation-warning 头部

​

与 OpenAI API 的差异

1. venice_parameters：额外的配置项如 enable_web_search、character_slug 和 strip_thinking_response，用于扩展功能
2. 系统 prompt：Venice 将您的系统 prompt 附加到针对无审查响应优化的默认值之后（使用 include_venice_system_prompt: false 禁用）
3. 模型生态：Venice 提供自己的模型阵容，包括无审查模型和推理模型——使用 Venice 模型 ID 而非 OpenAI 映射
4. 响应头：用于余额跟踪的独特头部（x-venice-balance-usd、x-venice-balance-diem）、模型弃用警告和内容安全标志
5. 内容政策：更宽松的政策，配有专门的无审查模型和可选的内容过滤

​

API 稳定性

​

OpenAPI 规范与原始数据

• OpenAPI 规范（YAML） — 完整的 API 规范，YAML 格式
• API 文档源码 — 所有文档页面（.mdx 格式）的可下载归档