快速接入教程

1. 获取 API 密钥

在使用 API 之前，您需要先获取 API 密钥：

登录用户中心
点击模型广场
进入 API 密钥页面
点击创建密钥按钮
设置密钥名称、可用模型、额度限制等参数
复制生成的 API Key（格式为 sk-xxx）

⚠️ 重要提示：API Key 只会显示一次，请妥善保存。如果丢失，需要重新创建密钥。

2. API 基础信息

项目	说明
基础 URL	https://www.yunsell.com
认证方式	Bearer Token
请求格式	JSON
响应格式	JSON / SSE（流式）

3. 快速测试

使用 curl 命令快速测试 API 是否正常工作。

3.1 获取模型列表

curl -X GET "{BASE_URL}/v1/models" \
  -H "Authorization: Bearer sk-your-api-key"

3.2 发起对话请求（非流式）

curl -X POST "{BASE_URL}/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "system", "content": "你是一个有帮助的助手。"},
      {"role": "user", "content": "你好，请介绍一下自己。"}
    ]
  }'

3.3 发起对话请求（流式）

curl -X POST "{BASE_URL}/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "讲一个短故事"}
    ],
    "stream": true
  }'

4. SDK 接入示例

4.1 Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="{BASE_URL}/v1"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": "你是一个有帮助的助手。"},
        {"role": "user", "content": "你好！"}
    ]
)

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

4.2 Node.js (OpenAI SDK)

import OpenAI from 'openai';

const openai = new OpenAI({
  apiKey: 'sk-your-api-key',
  baseURL: '{BASE_URL}/v1',
});

async function main() {
  const completion = await openai.chat.completions.create({
    model: 'gpt-4o',
    messages: [
      { role: 'system', content: '你是一个有帮助的助手。' },
      { role: 'user', content: '你好！' },
    ],
  });
  console.log(completion.choices[0].message.content);
}

main();

4.3 JavaScript/TypeScript (Fetch API)

async function chatCompletion() {
  const response = await fetch('{BASE_URL}/v1/chat/completions', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer sk-your-api-key',
    },
    body: JSON.stringify({
      model: 'gpt-4o',
      messages: [
        { role: 'user', content: '你好，请介绍一下自己。' },
      ],
    }),
  });
  const data = await response.json();
  console.log(data.choices[0].message.content);
}

5. 常见问题

Q: API 返回 401 错误？

检查 API Key 是否正确（是否包含 sk- 前缀）
检查 API Key 是否已过期或被禁用
确认请求头中的 Authorization 格式为 Bearer sk-xxx

Q: 模型不可用？

检查密钥是否有权限使用该模型
确认该模型在渠道中已配置

Q: 流式响应无法接收？

确保客户端支持 SSE (Server-Sent Events)
检查是否正确设置 stream: true

6. 下一步

查看 OpenAI Chat Completions 接入教程了解更多详情
查看 Anthropic Messages 接入教程了解 Claude API 接入
查看 SDK 示例获取更多代码示例

快速接入教程

On this page