开发文档

VERTEXHUB API 快速入门：OpenAI 兼容接口，Base URL 为 https://www.vertexhub.cn/v1，创建 API Key 后即可用 OpenAI SDK 或 curl 调用国内主流大模型。

快速入门

  1. 注册并登录 VERTEXHUB，在控制台的 API 密钥页面创建 API Key。
  2. 把 OpenAI SDK 的 Base URL 设为 https://www.vertexhub.cn/v1，请求头携带 Authorization: Bearer <API Key>。
  3. 在模型广场选择模型，把模型名填入 model 参数。

调用示例

以下示例用 curl 调用 Chat Completions 接口，返回格式与 OpenAI 一致：

curl https://www.vertexhub.cn/v1/chat/completions \
  -H "Authorization: Bearer $VERTEXHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "DeepSeek-V4-Pro", "messages": [{"role": "user", "content": "你好"}]}'

支持的接口

兼容 OpenAI 与 Anthropic 协议，常用端点如下：

  • POST /v1/chat/completions（OpenAI 对话）
  • POST /v1/completions（OpenAI 文本补全）
  • POST /v1/embeddings（向量）
  • POST /v1/images/generations（图片生成）
  • POST /v1/audio/speech、/v1/audio/transcriptions（语音）
  • POST /v1/messages（Anthropic Claude 协议）
  • GET /v1/models（可用模型列表）

常见问题

如何调用 VERTEXHUB 的模型 API？

登录控制台创建 API Key，把 OpenAI SDK 的 Base URL 设为 https://www.vertexhub.cn/v1，请求头带 Authorization: Bearer <你的 Key>，model 填模型广场里的模型名即可。切换模型只需改 model 参数。

VERTEXHUB 支持哪些接口协议？

兼容 OpenAI 的 /v1/chat/completions、/v1/completions、/v1/embeddings、/v1/images/generations、/v1/audio 等接口，并兼容 Anthropic Claude 的 /v1/messages 接口。

API 调用怎么计费？

按实际用量计费，以 V币 结算。每个模型的输入、输出单价（按每百万 token）或按次单价都公开在模型广场，调用明细与消费可在控制台实时查看。