⚡ 概述

RYZCBX API 是一个统一的大模型调用接口，兼容 OpenAI API 规范[reference:43]。通过一套 API 和一份 Token，开发者可以无缝调用平台上的 150+ 款模型，涵盖文本生成、图像生成、语音识别、多模态理解等全能力域[reference:44]。

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

🔐 认证与鉴权

RYZCBX API 使用 API Key 进行身份认证。所有请求必须在 HTTP Header 中携带 Authorization 字段[reference:45]。

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

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

📍 API 端点

端点	方法	描述
/v1/chat/completions	POST	对话补全（语言模型）
/v1/images/generations	POST	图像生成
/v1/embeddings	POST	文本向量化
/v1/models	GET	列出所有可用模型
/v1/balance	GET	查询账户余额

💬 对话补全 /v1/chat/completions

请求参数

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

请求示例

{
  "model": "deepseek-v3",
  "messages": [
    { "role": "system", "content": "你是一个专业的 AI 助手" },
    { "role": "user", "content": "解释一下什么是 Serverless 推理" }
  ],
  "temperature": 0.7,
  "max_tokens": 1024
}

响应示例

{
  "id": "chatcmpl-xxxxxxxx",
  "model": "deepseek-v3",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Serverless 推理是一种无需管理基础设施的 AI 模型调用方式..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 38,
    "completion_tokens": 112,
    "total_tokens": 150
  }
}

🎨 图像生成 /v1/images/generations

参数	类型	必填	描述
model	string	是	stable-diffusion-3、flux、kolors
prompt	string	是	图像描述提示词
size	string	否	1024x1024、1280x720
n	integer	否	生成数量，默认 1

📊 向量化 /v1/embeddings

参数	类型	必填	描述
model	string	是	向量化模型名称
input	string / array	是	待向量化的文本

❌ 错误码

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

📈 速率限制

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

📦 SDK 与工具

RYZCBX 官方提供以下编程语言的 SDK，所有 SDK 均兼容 OpenAI 的接口规范：

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

同时，RYZCBX API 完全兼容 OpenAI SDK，开发者可以直接使用 OpenAI 官方 SDK 调用 RYZCBX 的服务，只需替换 base_url 和 api_key 即可[reference:46]。