跳至主要内容
VOID

API 参考文档

使用 Void API 密钥访问兼容 OpenAI 的网关。从目录中选择模型 ID，并确认该模型支持你需要的接口和功能。

基础 URL 与身份验证

公共网关的基础 URL：https://void-api.tech/v1。请通过 HTTPS 发送请求。/v1 路由会转发至 LLM 网关；账户管理路由位于 /api/ 下。

在账户中创建密钥，并通过 Authorization: Bearer <your-api-key> 发送。请妥善保管密钥，不要将其写入浏览器代码或提交到代码仓库。用于 /api/ 的账户访问令牌与网关 API 密钥不同。

创建或管理 API 密钥连接客户端

列出模型

GET /v1/models 列出你的网关密钥可访问的模型。在推理请求中，使用返回结果 data 数组中的 id 作为 model 的值。公开的模型目录和价格也可在“模型”页面查看；可用性和功能因模型而异。

GET /v1/models
curl "https://void-api.tech/v1/models" \
  -H "Authorization: Bearer $VOID_API_KEY"

模型目录与价格公开模型目录（JSON）

GET /api/models/catalog 无需身份验证或 JavaScript。它返回一个 JSON 数组：name 是推理请求使用的模型 ID，group 是显示分组，所有 *_price_per_million_tokens 字段均以美元/百万 Token 为单位，涵盖输入、输出、缓存读取和缓存写入。价格以十进制字符串返回。请请求此端点获取最新价格，不要依赖记忆中的数值。此公开目录不能替代需要身份验证的 GET /v1/models 端点。

GET /api/models/catalog
curl -fsS "https://void-api.tech/api/models/catalog"

聊天补全

POST /v1/chat/completions 接收包含模型 ID 和消息的 OpenAI 风格 JSON 请求体。非流式请求返回聊天补全 JSON 响应；如有助手输出，可从 choices 中读取。字段和支持的消息内容取决于所选模型及提供商。

非流式请求
curl "https://void-api.tech/v1/chat/completions" \
  -H "Authorization: Bearer $VOID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<model-id>","messages":[{"role":"user","content":"Hello!"}]}'

要使用流式传输，请在 JSON 请求中添加 "stream": true。网关会返回包含增量片段的服务器发送事件（SSE），而不是单个完整的 JSON 响应。请在事件到达时处理它们，并处理流结束标记。并非所有模型或请求都会在流式传输中提供用量字段。

流式请求
curl -N "https://void-api.tech/v1/chat/completions" \
  -H "Authorization: Bearer $VOID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<model-id>","messages":[{"role":"user","content":"Hello!"}],"stream":true}'

响应 API

POST /v1/responses 会路由到 LLM 网关。仅当所选模型支持此接口时，才使用包含 model 和 input 的 OpenAI 风格请求。部分模型连接使用聊天模式，其他连接使用响应模式；不要假设每个模型都支持这两个接口。对于支持的模型，设置 "stream": true 可通过 SSE 接收响应事件，而不是单个 JSON 响应。这些事件的格式与聊天补全片段不同。

响应请求（适用于支持的模型）
curl "https://void-api.tech/v1/responses" \
  -H "Authorization: Bearer $VOID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<responses-capable-model-id>","input":"Hello!"}'

错误与兼容性

解析成功响应前，请先检查 HTTP 状态。身份验证或权限失败、无效请求、模型不可用、余额不足、速率限制及上游错误都可能导致调用失败。网关的错误响应体和状态码可能与账户 /api/ 的错误不同；不要假设所有路由都有相同的错误格式。使用 SSE 时，连接建立后也可能发生错误，因此还需处理流中断。

兼容 OpenAI 不代表所有模型或提供商的行为完全相同。参数、工具、多模态内容、流式事件和 Token 用量取决于所选模型及其底层提供商。请从最简示例开始，并针对目标模型验证其他功能。

计费与账户

公开模型目录中列有 Token 价格。你可以在账户中管理余额并查看用量。价格和可用性可能变化；发送请求前请查看最新目录。

模型价格余额用量支付与退款条款