API 手册

​

平台特色

​

OpenAI 兼容模式

• 支持的模型厂商：
  • 🤖 OpenAI：gpt-4o、gpt-5-chat-latest、gpt-3.5-turbo等
  • 🧠 Anthropic：claude-sonnet-4-20250514、claude-opus-4-1-20250805 等
  • 💎 Google：gemini-2.5-pro、gemini-2.5-flash 等
  • 🚀 xAI：grok-4-0709、grok-3 等
  • 🔍 DeepSeek：deepSeek-r1、deepSeek-v3 等
  • 🌟 阿里：Qwen系列模型
  • 💬 Moonshot：Kimi模型等

​

功能支持范围

• ✅ 支持的功能：
  • 💬 对话补全：Chat Completions接口
  • 🖼️ 图像生成：gpt-image-1、flux-kontext-pro、flux-kontext-max 等
  • 🔊 语音处理：Whisper转录
  • 📊 嵌入向量：文本向量化
  • ⚡ 函数调用：Function Calling
  • 📡 流式输出：实时响应
  • 🔧 OpenAI参数：temperature、top_p、max_tokens等
  • 🆕 Responses端点：OpenAI最新功能
• ❌ 不支持的功能：
  • 🔧 微调接口（Fine-tuning）
  • 📁 Files管理接口
  • 🏢 组织管理接口
  • 💳 计费管理接口

​

简单切换模型

# 使用GPT-4o
response = client.chat.completions.create(
    model="gpt-4o", # OpenAI模型
    messages=[...]
)

# 切换到Claude，其他代码完全不变！
response = client.chat.completions.create(
    model="claude-3.5-sonnet", # 只改模型名
    messages=[...]
)

# 切换到Gemini
response = client.chat.completions.create(
    model="gemini-1.5-pro", # 只改模型名
    messages=[...]
)

​

快速开始

​

获取API Key

1. 访问weelinking控制台
2. 登录您的账户
3. 在令牌管理页面点击”新增”创建API Key
4. 复制生成的API Key用于接口调用

​

查看请求示例

​

基础信息

• API 端点:
  • 主要端点： https://api.weelinking.com/v1
  • 备用端点： https://vip.weelinking.com/v1
• 认证方式:
  • Header: Authorization: Bearer YOUR_API_KEY
• 请求格式:
  • Content-Type: application/json
  • 编码格式：UTF-8

​

核心接口

​

1. 对话补全（Chat Completions）

• 请求端点: POST /v1/chat/completions
• 请求参数:
  • model (string, 必填): 模型名称
  • messages (array, 必填): 对话消息数组
  • temperature (number): 采样温度，0-2之间，默认1
  • max_tokens (integer): 最大生成令牌数
  • stream (boolean): 是否流式返回，默认false
• 完整代码示例 (cURL):
  Copy

  curl -X POST "https://api.weelinking.com/v1/chat/completions" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "gpt-3.5-turbo",
      "messages": [
        {"role": "system", "content": "你是一个有用的AI助手。"},
        {"role": "user", "content": "你好！请介绍一下自己。"}
      ],
      "temperature": 0.7,
      "max_tokens": 1000
    }'
  

​

2. 文本补全（Completions）

• 请求端点: POST /v1/completions

​

3. 嵌入向量（Embeddings）

• 请求端点: POST /v1/embeddings

​

4. 图像生成（Images）

• 请求端点: POST /v1/images/generations
• 代码示例:
  Copy

  curl -X POST "https://api.weelinking.com/v1/images/generations" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "gpt-image-1",
      "prompt": "一只可爱的橙色小猫坐在阳光明媚的花园里",
      "n": 1,
      "size": "1024x1024",
      "quality": "hd"
    }'
  

​

5. 音频转文字（Audio）

• 请求端点: POST /v1/audio/transcriptions

​

6. 模型列表

• 请求端点: GET /v1/models

​

流式响应

​

开启流式输出

​

流式响应格式

data: {"id":"chatcmpl-123",...}
data: {"id":"chatcmpl-123",...}
data: [DONE]

​

错误处理

​

常见错误码

• 401 invalid_api_key: API密钥无效
• 429 insufficient_quota: 额度不足
• 404 model_not_found: 模型不存在
• 400 invalid_request_error: 请求参数错误
• 500 server_error: 服务器内部错误

​

最佳实践

1. 请求优化: 合理设置 max_tokens，使用 temperature 控制随机性。
2. 错误重试: 实现指数退避的重试机制。
3. 安全建议: 保护API密钥，使用环境变量存储。
4. 性能优化: 使用流式输出，缓存响应。