API 调用示例

将 KvioAI 平台地址替换为 OpenAI 的 base_url，使用平台颁发的令牌作为 api_key，即可开始调用。

获取 API 地址

复制 API 地址

1. 访问 KvioAI 平台首页
2. 在页面中部找到 API Base URL 显示区域
3. 点击复制按钮，将地址 https://kvioai.cloud/v1 复制到剪贴板

配置客户端

将复制的地址填入你的客户端或代码中作为 base_url，配合令牌即可开始调用。

代码示例

Python（OpenAI SDK）

安装 OpenAI SDK：

pip install openai

Python 代码示例：

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxx",
    base_url="https://kvioai.cloud/v1"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)

Claude 原生格式

使用 curl 调用：

curl https://kvioai.cloud/v1/messages \
  -H "x-api-key: sk-xxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-4-20250514", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}]}'

Python 调用：

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-xxx",
    base_url="https://kvioai.cloud/v1"
)

message = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}]
)

print(message.content[0].text)

Node.js 调用：

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  apiKey: "sk-xxx",
  baseURL: "https://kvioai.cloud/v1",
});

const message = await client.messages.create({
  model: "claude-sonnet-4-20250514",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Hello" }],
});

console.log(message.content[0].text);

Gemini 原生格式

使用 curl 调用：

curl "https://kvioai.cloud/v1beta/models/gemini-1.5-pro:generateContent?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents": [{"parts": [{"text": "Hello"}]}]}'

OpenAI 格式 - curl 调用

curl -s -X POST "https://kvioai.cloud/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxx" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好，请介绍一下你自己"}],
    "max_tokens": 1024,
    "temperature": 0.7
  }'

Node.js（OpenAI SDK）

安装 OpenAI SDK：

npm install openai

Node.js 代码示例：

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-xxx",
  baseURL: "https://kvioai.cloud/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [{ role: "user", content: "你好，请介绍一下你自己" }],
  max_tokens: 1024,
  temperature: 0.7,
});

console.log(response.choices[0].message.content);

流式输出（Streaming）

OpenAI 格式 - Python 流式调用

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxx",
    base_url="https://kvioai.cloud/v1"
)

stream = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "请写一首关于春天的诗"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Anthropic 格式 - Python 流式调用

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-xxx",
    base_url="https://kvioai.cloud/v1"
)

with client.messages.stream(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[{"role": "user", "content": "请写一首关于春天的诗"}]
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

支持的接口端点

接口	路径	说明
聊天补全	POST /v1/chat/completions	对话生成，支持流式输出
文本补全	POST /v1/completions	传统补全接口
向量嵌入	POST /v1/embeddings	文本向量化
图像生成	POST /v1/images/generations	文生图
语音转文字	POST /v1/audio/transcriptions	Whisper 等
文字转语音	POST /v1/audio/speech	TTS
模型列表	GET /v1/models	查询可用模型

常见问题

如何查看可用的模型列表？

curl -s "https://kvioai.cloud/v1/models" \
  -H "Authorization: Bearer sk-xxx"

返回了 401 错误？

• 确认 API Key 正确，只复制 key 字段的值，不要带入 JSON 的引号或多余字符
• 确认环境变量已生效（运行 echo $OPENAI_API_KEY 或 echo $ANTHROPIC_API_KEY 检查）

返回了 404 错误？

• 确认 Base URL 正确，需要包含 /v1 后缀
• 确认模型名称拼写正确

返回了 500 错误？

• 可能是后端服务暂时不可用，稍后重试
• 确认模型名称是否在该分组中可用

📱 获取帮助 使用过程中如有问题，请添加微信 vp4wt 获取技术支持。