⚜️ 概述

VXVGBF API 是一个统一的 AI 模型调用接口，通过一份通用代币和一套 RESTful API 规范，让开发者可以无缝调用全球主流的图像生成、视频合成、语言对话和多模态理解模型。

基础 URL： https://api.vxvgbf.cn/v1
API 版本： v1（稳定版）
数据格式： 所有请求与响应均使用 application/json

⚜️ 认证与鉴权

VXVGBF API 使用 API Key 进行身份认证。所有请求必须在 HTTP Header 中携带 Authorization 字段。

# 请求头示例
Authorization: Bearer vx_xxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

API Key 可在控制台的「API 密钥」页面生成和管理。每个账号最多可创建 10 个 API Key，支持独立设置权限和 IP 白名单。

⚜️ API 端点

端点	方法	描述
/v1/chat/completions	POST	语言模型对话补全
/v1/images/generations	POST	图像生成
/v1/videos/generations	POST	视频生成
/v1/models	GET	列出所有可用模型
/v1/balance	GET	查询代币余额

⚜️ 对话补全 /v1/chat/completions

请求参数

参数	类型	必填	描述
model	string	是	模型名称，如 claude-3.5-sonnet、gpt-4o
messages	array	是	对话消息列表，每项包含 role 和 content
temperature	number	否	0~2，默认 1.0
max_tokens	integer	否	最大输出长度，默认 4096
stream	boolean	否	是否流式输出，默认 false

请求示例

{
  "model": "claude-3.5-sonnet",
  "messages": [
    { "role": "system", "content": "你是一个专业的 AI 助手" },
    { "role": "user", "content": "解释一下什么是通用代币" }
  ],
  "temperature": 0.7,
  "max_tokens": 1024
}

响应示例

{
  "id": "chatcmpl-xxxxxxxx",
  "model": "claude-3.5-sonnet",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "通用代币是一种统一的 AI 服务计价单位..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 42,
    "completion_tokens": 128,
    "total_tokens": 170
  }
}

⚜️ 图像生成 /v1/images/generations

参数	类型	必填	描述
model	string	是	dall-e-3、stable-diffusion-3
prompt	string	是	图像描述提示词
size	string	否	1024x1024、1792x1024
quality	string	否	standard 或 hd
n	integer	否	生成数量，默认 1

⚜️ 视频生成 /v1/videos/generations

参数	类型	必填	描述
model	string	是	kling、seedance-2.0
prompt	string	是	视频描述提示词
duration	integer	否	视频时长（秒），默认 5
resolution	string	否	720p 或 1080p

⚜️ 错误码

HTTP 状态码	错误码	描述
401	unauthorized	API Key 无效或缺失
402	insufficient_balance	代币余额不足
404	model_not_found	指定的模型不存在
429	rate_limit_exceeded	请求频率超限
500	internal_error	服务器内部错误

⚜️ 速率限制

VXVGBF API 对不同套餐设有不同的速率限制。免费试用账号：10 请求/分钟；专业版：100 请求/分钟；企业版：500 请求/分钟（可申请扩容）。

超出速率限制时，API 返回 429 状态码，响应头中包含 Retry-After 字段，指示需要等待的秒数。

⚜️ SDK 与工具

VXVGBF 官方提供以下编程语言的 SDK：

• Python — pip install vxvgbf
• JavaScript / TypeScript — npm install @vxvgbf/sdk
• Go — go get github.com/vxvgbf/go-sdk
• Java — Maven: com.vxvgbf:sdk:1.0.0
• Rust — cargo add vxvgbf

所有 SDK 均已在 GitHub 开源，欢迎提交 Issue 和 Pull Request。