新用户新用户即享 DNS 与 CDN 免费套餐。立即注册
登录免费注册
文档
控制台

快速开始

开通 LLM API、准备额度、创建密钥，并用 curl、Python 和 Node.js 发出第一个请求。

8 分钟阅读 更新于 2026年10月6日

本文带您从零开始完成一次 LLM API 调用：开通服务、准备额度、创建密钥，然后分别用 curl、Python 和 Node.js 发送请求。

接入信息

项目值
基础地址（Base URL）https://llm.yeap.cloud/v1
鉴权方式请求头 Authorization: Bearer <您的密钥>
密钥格式以 sk- 开头的字符串
接口规范兼容 OpenAI API

控制台 LLM API → 账户概览 页面右侧的 API 信息 面板列出了常用接口地址，可一键复制：

接口用途
/v1/chat/completions对话
/v1/completions文本补全
/v1/embeddings向量嵌入
/v1/images/generations图像生成
/v1/audio/transcriptions语音转文字
/v1/models查询可用模型

第 1 步：开通服务

  1. 登录控制台，在左侧菜单打开 LLM API → 账户概览（/llm/account）。
  2. 首次进入会提示"服务未开通"，点击 立即开通。
  3. 开通成功后，页面会显示账户数据、使用统计、图表和 API 信息。

第 2 步：准备额度

调用模型会消耗 LLM 账户中的额度。为额度充值有两种方式：

  • 从主账户余额划转：在 账户概览 的"当前余额"卡片上点击 划转，输入金额后点击 确认划转。最小划转金额为 1，弹窗中会显示预计获得的额度。
  • 兑换码：如果您有兑换码，在 兑换码充值 卡片中输入并点击 兑换。

如需先给主账户充值，点击"当前余额"卡片上的 充值，会跳转到 财务管理 → 账户余额（/billing/balance）。

Warning

划转到 LLM API 的额度不支持退回主账户余额，请按需划转。

第 3 步：创建 API 密钥

  1. 打开 LLM API → 密钥管理（/llm/tokens）。
  2. 点击右上角 创建密钥。
  3. 填写 名称（必填），其余选项可先保持默认：默认分组、不限模型、不限 IP、永不过期。各选项的含义见 密钥、额度与用量。
  4. 点击 创建，在弹出的"新密钥已创建"对话框中复制以 sk- 开头的完整密钥。
Tip

不要把密钥写进前端代码或提交到代码仓库。建议通过环境变量传入，例如 export YEAP_LLM_API_KEY=sk-...。

第 4 步：选择模型

在 LLM API → 模型列表（/llm/models）中查看模型名称和价格，或者直接调用接口查询：

bash
curl https://llm.yeap.cloud/v1/models \
  -H "Authorization: Bearer $YEAP_LLM_API_KEY"

本文示例使用 gpt-4o-mini。模型是否可用取决于您的密钥所在分组以及平台当前的上架情况，请以模型列表为准，并在示例中替换为您要用的模型名称。

第 5 步：发送请求

curl

bash
curl https://llm.yeap.cloud/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YEAP_LLM_API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "system", "content": "你是一个有帮助的助手。"},
      {"role": "user", "content": "用一句话介绍你自己。"}
    ]
  }'

如需流式输出，在请求体中加入 "stream": true，响应将以 Server-Sent Events（SSE）格式逐段返回。

Python（openai SDK）

先安装 SDK：pip install openai。

python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["YEAP_LLM_API_KEY"],
    base_url="https://llm.yeap.cloud/v1",
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "用一句话介绍你自己。"}],
)
print(resp.choices[0].message.content)

# 流式输出
stream = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "写一首四行短诗。"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Node.js（openai SDK）

先安装 SDK：npm install openai。

javascript
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.YEAP_LLM_API_KEY,
  baseURL: "https://llm.yeap.cloud/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "用一句话介绍你自己。" }],
});
console.log(resp.choices[0].message.content);

向量嵌入示例

bash
curl https://llm.yeap.cloud/v1/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YEAP_LLM_API_KEY" \
  -d '{"model": "text-embedding-3-small", "input": "Yeap Cloud"}'

第 6 步：查看用量

调用完成后，打开 LLM API → 使用日志 即可看到这次请求的模型、输入/输出 Token 数和花费。详见 密钥、额度与用量。

常见问题

  • 返回 401，提示未提供令牌：检查请求头是否为 Authorization: Bearer sk-...，注意 Bearer 后有一个空格。
  • 提示额度不足：账户余额或密钥额度已用完。前者请划转或兑换额度，后者请在密钥管理中提高该密钥的额度上限或开启无限配额。
  • 提示模型不可用：该模型不在密钥所在分组中，或被密钥的"模型限制"排除。请在模型列表中确认，或更换分组/模型。
  • 请求被拒绝且密钥设置了 IP 限制：确认发起请求的服务器出口 IP 在白名单中。
  • 使用第三方客户端：在客户端中选择"OpenAI 兼容"类型，地址填 https://llm.yeap.cloud/v1（部分客户端只需填 https://llm.yeap.cloud，会自动补全 /v1），密钥填 sk-...。
本页内容是否有帮助？