渡元AI
欢迎使用渡元AI。我们的平台为您提供稳定、高效的接口转发服务,助您即刻接入全球领先的人工智能模型。
快速开始
新人福利:在您注册并登录后,系统会自动向您的账户发放一定的体验额度。您可以在模型市场中浏览和测试各类 AI 模型,快速熟悉我们的服务流程。
钱包与充值
充值流程
- 进入钱包管理页面。
- 选择充值金额。
- 选择支付方式完成付款。
- 系统将自动跳转回账单页,您可实时查看到账额度。
- 支付成功后,您的账户余额将即时更新。
余额查阅:在钱包管理界面,您可以实时监控当前账户余额。我们采用按量付费模式,只要账户有余额,即可自由调用平台支持的所有模型。
API 令牌管理
创建令牌
要开始调用接口,您需要生成唯一的 API 密钥。在令牌管理页面,您可以创建并管理您的多组令牌。登录控制台后,进入令牌管理,点击添加令牌即可生成新的 API 密钥。生成后请妥善保管,密钥仅在创建时显示一次。
接口使用说明
API 基础信息
API 基础地址
常用聊天端点
您只需将API 接口地址与您的API 密钥配置到您的应用中即可开始使用。
💡 提示:渡元AI 完全兼容 OpenAI API 格式。如果您已有使用 OpenAI SDK 的项目,只需将 base_url 改为 https://www.haohuopu.com 并替换 API 密钥即可无缝迁移。
服务条款
法律声明
⚠ 法律声明
在您开始使用我们的服务前,请务必阅读以下条款:
- 本网站不承诺任何形式的正向质保。
- 因不可抗力或外部原因导致网站不可用时,不支持退款申请。
- 本网站对所有服务条款拥有最终解释权。
* 充值并使用服务即代表您已完全理解并同意以上条款。
渡元AI API 参考
渡元AI 提供兼容 OpenAI 格式的 API 接口,支持聊天补全、文本补全、嵌入向量、音频生成、图像生成、重排序和内容审核等功能。
https://www.haohuopu.com快速开始
在控制台获取您的 API 密钥后,即可开始调用:
curl https://www.haohuopu.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-YOUR-KEY" \
-d '{
"model": "gpt-4o",
"messages": [{"role": "user", "content": "你好,渡元AI!"}]
}'from openai import OpenAI
client = OpenAI(
base_url="https://www.haohuopu.com/v1",
api_key="sk-YOUR-KEY"
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "你好,渡元AI!"}]
)
print(response.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://www.haohuopu.com/v1",
apiKey: "sk-YOUR-KEY"
});
const response = await client.chat.completions.create({
model: "gpt-4o",
messages: [{ role: "user", content: "你好,渡元AI!" }]
});
console.log(response.choices[0].message.content);认证方式
所有 API 请求通过 HTTP Bearer Token 认证:
Authorization: Bearer sk-YOUR-KEY
支持的模型
| 厂商 | 模型 | 类型 |
|---|---|---|
| OpenAI | gpt-4o, gpt-4o-mini, gpt-4-turbo | 聊天 |
| Anthropic | claude-3.5-sonnet, claude-3-opus | 聊天 |
gemini-2.0-flash, gemini-1.5-pro | 聊天 | |
| DeepSeek | deepseek-chat, deepseek-reasoner | 聊天 |
| Meta | llama-3.3-70b | 聊天 |
错误码
| 状态码 | 说明 |
|---|---|
200 | 请求成功 |
400 | 请求参数错误 |
401 | API Key 无效或已过期 |
402 | 余额不足 |
429 | 请求频率超限 |
500 | 服务器内部错误 |
聊天补全 (Chat Completions)
创建聊天补全响应,支持多轮对话、流式输出、函数调用和视觉输入。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型 ID |
messages | array | 是 | 消息列表,每条含 role 和 content |
temperature | number | 否 | 采样温度 0~2,默认 1 |
max_tokens | integer | 否 | 最大输出 token 数 |
stream | boolean | 否 | 是否流式输出,默认 false |
top_p | number | 否 | 核采样参数 |
tools | array | 否 | 函数调用工具定义 |
代码示例
curl https://www.haohuopu.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-YOUR-KEY" \
-d '{
"model": "gpt-4o",
"messages": [
{"role": "system", "content": "你是渡元AI助手。"},
{"role": "user", "content": "解释量子计算的基本原理"}
],
"temperature": 0.7,
"max_tokens": 1000
}'from openai import OpenAI
client = OpenAI(base_url="https://www.haohuopu.com/v1", api_key="sk-YOUR-KEY")
response = client.chat.completions.create(
model="gpt-4o",
messages=[
{"role": "system", "content": "你是渡元AI助手。"},
{"role": "user", "content": "解释量子计算的基本原理"}
],
temperature=0.7, max_tokens=1000
)
print(response.choices[0].message.content)const response = await fetch("https://www.haohuopu.com/v1/chat/completions", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer sk-YOUR-KEY"
},
body: JSON.stringify({
model: "gpt-4o",
messages: [
{ role: "system", content: "你是渡元AI助手。" },
{ role: "user", content: "解释量子计算的基本原理" }
],
temperature: 0.7, max_tokens: 1000
})
});
const data = await response.json();
console.log(data.choices[0].message.content);流式输出示例
设置 stream: true 即可启用 SSE 流式输出:
curl https://www.haohuopu.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-YOUR-KEY" \
-d '{"model":"gpt-4o","messages":[{"role":"user","content":"讲个故事"}],"stream":true}'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="")响应格式
{
"id": "chatcmpl-xxx",
"object": "chat.completion",
"created": 1700000000,
"model": "gpt-4o",
"choices": [{
"index": 0,
"message": {"role": "assistant", "content": "量子计算利用量子比特..."},
"finish_reason": "stop"
}],
"usage": {"prompt_tokens": 20, "completion_tokens": 50, "total_tokens": 70}
}文本补全 (Completions)
传统文本补全接口,根据提示词生成续写文本。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型 ID,如 gpt-3.5-turbo-instruct |
prompt | string | array | 是 | 提示词 |
max_tokens | integer | 否 | 最大输出 token 数,默认 16 |
temperature | number | 否 | 采样温度 0~2 |
stream | boolean | 否 | 流式输出 |
n | integer | 否 | 生成数量,默认 1 |
代码示例
curl https://www.haohuopu.com/v1/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-YOUR-KEY" \
-d '{
"model": "gpt-3.5-turbo-instruct",
"prompt": "渡元AI是一个强大的AI平台,",
"max_tokens": 100, "temperature": 0.8
}'response = client.completions.create(
model="gpt-3.5-turbo-instruct",
prompt="渡元AI是一个强大的AI平台,",
max_tokens=100, temperature=0.8
)
print(response.choices[0].text)响应格式
{
"id": "cmpl-xxx",
"object": "text_completion",
"created": 1700000000,
"model": "gpt-3.5-turbo-instruct",
"choices": [{"text": "可以提供多种AI服务...", "index": 0, "finish_reason": "stop"}],
"usage": {"prompt_tokens": 8, "completion_tokens": 12, "total_tokens": 20}
}嵌入向量 (Embeddings)
将文本转换为向量嵌入,用于语义搜索、聚类和相似度计算。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型 ID,如 text-embedding-3-small |
input | string | array | 是 | 输入文本,支持批量 |
encoding_format | string | 否 | float 或 base64 |
代码示例
curl https://www.haohuopu.com/v1/embeddings \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-YOUR-KEY" \
-d '{"model":"text-embedding-3-small","input":"渡元AI提供高质量的AI服务"}'response = client.embeddings.create(
model="text-embedding-3-small",
input="渡元AI提供高质量的AI服务"
)
print(response.data[0].embedding[:5])响应格式
{
"object": "list",
"data": [{"object": "embedding", "index": 0, "embedding": [0.0012, -0.0045, 0.0231, ...]}],
"model": "text-embedding-3-small",
"usage": {"prompt_tokens": 6, "total_tokens": 6}
}音频 - Gemini 格式
使用 Google Gemini 原生格式进行音频内容生成。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model (path) | string | 是 | 如 gemini-2.0-flash |
contents | array | 是 | 内容数组 |
generationConfig | object | 否 | 生成配置 |
safetySettings | array | 否 | 安全设置 |
代码示例
curl "https://www.haohuopu.com/v1beta/models/gemini-2.0-flash:generateContent?key=sk-YOUR-KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [{"parts": [{"text": "解释渡元AI"}]}],
"generationConfig": {"temperature": 0.9, "maxOutputTokens": 2048}
}'import requests
response = requests.post(
"https://www.haohuopu.com/v1beta/models/gemini-2.0-flash:generateContent",
params={"key": "sk-YOUR-KEY"},
json={"contents": [{"parts": [{"text": "解释渡元AI"}]}], "generationConfig": {"temperature": 0.9}}
)
print(response.json())音频 - OpenAI TTS
使用 OpenAI 兼容格式将文本转为语音(TTS)。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | tts-1, tts-1-hd |
input | string | 是 | 要转换的文本,最大 4096 字符 |
voice | string | 是 | alloy, echo, fable, onyx, nova, shimmer |
speed | number | 否 | 语速 0.25~4.0,默认 1.0 |
response_format | string | 否 | mp3, opus, aac, flac, wav, pcm |
代码示例
curl https://www.haohuopu.com/v1/audio/speech \
-H "Authorization: Bearer sk-YOUR-KEY" \
-H "Content-Type: application/json" \
-d '{"model":"tts-1","input":"欢迎使用渡元AI平台!","voice":"alloy"}' \
--output speech.mp3response = client.audio.speech.create(
model="tts-1", voice="alloy",
input="欢迎使用渡元AI平台!"
)
response.stream_to_file("speech.mp3")图像生成 (Images)
使用 DALL·E 等模型根据文本描述生成图像。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 否 | dall-e-3, dall-e-2 |
prompt | string | 是 | 图像描述,最大 4000 字符 |
n | integer | 否 | 生成数量 1~10 |
size | string | 否 | 1024x1024, 1792x1024, 1024x1792 |
quality | string | 否 | standard / hd |
style | string | 否 | vivid / natural |
代码示例
curl https://www.haohuopu.com/v1/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-YOUR-KEY" \
-d '{
"model":"dall-e-3",
"prompt":"赛博朋克风格的小猫,霓虹灯背景",
"n":1,"size":"1024x1024"
}'response = client.images.generate(
model="dall-e-3",
prompt="赛博朋克风格的小猫,霓虹灯背景",
n=1, size="1024x1024"
)
print(response.data[0].url)响应格式
{
"created": 1700000000,
"data": [{"url": "https://...", "revised_prompt": "赛博朋克风格的小猫..."}]
}重排序 (Rerank)
对搜索结果进行语义重排序,提高检索精度。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 重排序模型 |
query | string | 是 | 查询文本 |
documents | array | 是 | 待排序文档列表 |
top_n | integer | 否 | 返回前 N 条结果 |
代码示例
curl https://www.haohuopu.com/v1/rerank \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-YOUR-KEY" \
-d '{
"model":"bge-reranker-v2-m3",
"query":"渡元AI有哪些功能?",
"documents":["渡元AI支持聊天","今天天气好","渡元AI支持图像生成"],
"top_n":2
}'import requests
response = requests.post(
"https://www.haohuopu.com/v1/rerank",
headers={"Authorization": "Bearer sk-YOUR-KEY"},
json={"model":"bge-reranker-v2-m3","query":"渡元AI有哪些功能?",
"documents":["渡元AI支持聊天","今天天气好","渡元AI支持图像生成"],"top_n":2}
)
print(response.json())响应格式
{
"results": [
{"index":0,"relevance_score":0.95,"document":"渡元AI支持聊天"},
{"index":2,"relevance_score":0.87,"document":"渡元AI支持图像生成"}
]
}内容审核 (Moderations)
审核输入文本是否包含有害内容。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
input | string | array | 是 | 待审核文本 |
model | string | 否 | 默认 text-moderation-latest |
代码示例
curl https://www.haohuopu.com/v1/moderations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-YOUR-KEY" \
-d '{"input":"这是一条正常的内容"}'响应格式
{
"id":"modr-xxx","model":"text-moderation-latest",
"results":[{
"flagged":false,
"categories":{"hate":false,"self-harm":false,"sexual":false,"violence":false},
"category_scores":{"hate":0.001,"violence":0.002}
}]
}