中转站使用教程

小椰子 🥥2025/11/22大约 4 分钟

中转站（API）使用教程

椰子 API 是一个高性能的 AI API 中转服务，为开发者提供稳定、快速的 AI 接口调用能力。

什么是中转站

中转站（API 中转）提供：

🚀 高速稳定：优化的网络线路，低延迟访问
🔌 标准接口：兼容 OpenAI API 格式
💰 灵活计费：按量付费，成本可控
🛡️ 安全可靠：加密传输，数据安全

API 地址

API 端点

主 API：https://api.yeahzi.app/v1
备用 API：待添加

快速开始

1. 获取 API Key

登录椰子 AI 账号
进入「API 管理」页面
点击「创建新密钥」
复制保存 API Key（只显示一次）

安全提示

请妥善保管 API Key，不要泄露给他人。如发现泄露，请立即删除并重新创建。

2. 测试连接

使用 curl 命令测试：

curl https://api.yeahzi.app/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-3.5-turbo",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

使用示例

Python

import openai

# 配置 API
openai.api_base = "https://api.yeahzi.app/v1"
openai.api_key = "YOUR_API_KEY"

# 发送请求
response = openai.ChatCompletion.create(
    model="gpt-3.5-turbo",
    messages=[
        {"role": "user", "content": "你好！"}
    ]
)

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

Node.js

import OpenAI from 'openai';

const openai = new OpenAI({
  baseURL: 'https://api.yeahzi.app/v1',
  apiKey: 'YOUR_API_KEY',
});

async function main() {
  const completion = await openai.chat.completions.create({
    model: 'gpt-3.5-turbo',
    messages: [
      { role: 'user', content: '你好！' }
    ],
  });

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

main();

Go

package main

import (
    "context"
    "fmt"
    openai "github.com/sashabaranov/go-openai"
)

func main() {
    config := openai.DefaultConfig("YOUR_API_KEY")
    config.BaseURL = "https://api.yeahzi.app/v1"
    client := openai.NewClientWithConfig(config)

    resp, err := client.CreateChatCompletion(
        context.Background(),
        openai.ChatCompletionRequest{
            Model: openai.GPT3Dot5Turbo,
            Messages: []openai.ChatCompletionMessage{
                {
                    Role:    openai.ChatMessageRoleUser,
                    Content: "你好！",
                },
            },
        },
    )

    if err != nil {
        fmt.Printf("Error: %v\n", err)
        return
    }

    fmt.Println(resp.Choices[0].Message.Content)
}

Java

import com.theokanning.openai.service.OpenAiService;
import com.theokanning.openai.completion.chat.*;

import java.util.*;

public class Main {
    public static void main(String[] args) {
        OpenAiService service = new OpenAiService("YOUR_API_KEY");

        // 设置自定义 API 地址需要修改源码或使用其他库

        ChatCompletionRequest request = ChatCompletionRequest.builder()
            .model("gpt-3.5-turbo")
            .messages(Arrays.asList(
                new ChatMessage("user", "你好！")
            ))
            .build();

        ChatCompletionResult result = service.createChatCompletion(request);
        System.out.println(result.getChoices().get(0).getMessage().getContent());
    }
}

支持的模型

OpenAI 模型

模型名称	说明	上下文长度
gpt-4	GPT-4 最新版本	8K tokens
gpt-4-32k	GPT-4 长上下文版本	32K tokens
gpt-3.5-turbo	GPT-3.5 最新版本	4K tokens
gpt-3.5-turbo-16k	GPT-3.5 长上下文版本	16K tokens

Claude 模型

模型名称	说明	上下文长度
claude-3-opus	Claude 3 最强版本	200K tokens
claude-3-sonnet	Claude 3 平衡版本	200K tokens
claude-3-haiku	Claude 3 快速版本	200K tokens

其他模型

Gemini Pro
文心一言
通义千问

API 参数说明

基础参数

{
  "model": "gpt-3.5-turbo",      // 必填：模型名称
  "messages": [...],              // 必填：对话消息
  "temperature": 0.7,             // 可选：随机性 (0-2)
  "top_p": 1,                     // 可选：核采样
  "n": 1,                         // 可选：返回结果数量
  "stream": false,                // 可选：是否流式输出
  "max_tokens": 1000,             // 可选：最大生成长度
  "presence_penalty": 0,          // 可选：话题新鲜度
  "frequency_penalty": 0          // 可选：重复惩罚
}

流式输出

import openai

openai.api_base = "https://api.yeahzi.app/v1"
openai.api_key = "YOUR_API_KEY"

response = openai.ChatCompletion.create(
    model="gpt-3.5-turbo",
    messages=[{"role": "user", "content": "讲个故事"}],
    stream=True  # 启用流式输出
)

for chunk in response:
    if chunk.choices[0].delta.get("content"):
        print(chunk.choices[0].delta.content, end="")

计费说明

计费方式

按 Token 使用量计费
不同模型单价不同
输入 Token 和输出 Token 分别计费

价格参考

模型	输入价格	输出价格
GPT-3.5	¥0.002/1K tokens	¥0.002/1K tokens
GPT-4	¥0.03/1K tokens	¥0.06/1K tokens
Claude 3	¥0.015/1K tokens	¥0.075/1K tokens

提示

具体价格以平台实时显示为准

查看用量

登录后台管理
进入「API 使用统计」
查看详细使用记录和费用

最佳实践

错误处理

import openai
from openai.error import OpenAIError

try:
    response = openai.ChatCompletion.create(
        model="gpt-3.5-turbo",
        messages=[{"role": "user", "content": "Hello"}]
    )
except OpenAIError as e:
    print(f"API Error: {e}")
except Exception as e:
    print(f"Unexpected Error: {e}")

超时设置

import openai

openai.api_base = "https://api.yeahzi.app/v1"
openai.api_key = "YOUR_API_KEY"

# 设置超时时间（秒）
response = openai.ChatCompletion.create(
    model="gpt-3.5-turbo",
    messages=[{"role": "user", "content": "Hello"}],
    request_timeout=30  # 30秒超时
)

重试机制

import time
import openai

def chat_with_retry(messages, max_retries=3):
    for attempt in range(max_retries):
        try:
            response = openai.ChatCompletion.create(
                model="gpt-3.5-turbo",
                messages=messages
            )
            return response
        except Exception as e:
            if attempt == max_retries - 1:
                raise e
            time.sleep(2 ** attempt)  # 指数退避

常见问题

API 相关

Q: API Key 如何保密？

A: 建议：

使用环境变量存储
不要提交到代码仓库
定期轮换密钥
使用密钥管理服务

Q: 为什么请求失败？

A: 可能原因：

API Key 错误或过期
余额不足
请求参数错误
网络连接问题
超过速率限制

Q: 如何提高请求速度？

A: 建议：

使用流式输出
减少 max_tokens
选择响应更快的模型
使用最近的 API 端点

计费相关

Q: Token 是如何计算的？

A: Token 是文本的最小单位，中文通常 1.5-2 个字符为 1 个 token，英文约 4 个字符为 1 个 token。

Q: 如何节省费用？

A: 建议：

优化提示词，减少不必要的输入
使用更便宜的模型（如 GPT-3.5）
设置合理的 max_tokens
缓存常见问题的回答

Q: 可以设置消费限额吗？

A: 可以在后台设置每日/每月消费上限，超过后自动停止服务。

技术支持

遇到技术问题可以：

📖 查看 API 文档
💬 加入开发者交流群
📧 发送邮件到技术支持
🐛 在 GitHub 提交 Issue（如有）

注意事项

使用限制

🚫 请勿滥用 API 资源
🚫 请勿用于违法用途
✅ 遵守速率限制
✅ 合理使用服务

安全警告

🔐 不要在客户端直接使用 API Key
🛡️ 使用后端代理转发请求
🔒 启用 IP 白名单（如需要）
⚠️ 监控异常调用行为