Быстрый старт

Это руководство поможет выполнить первый вызов LLM API: активировать сервис, пополнить квоту, создать ключ и отправить запросы с помощью curl, Python и Node.js.

#Параметры подключения

На панели Сведения об API страницы LLM API → Обзор аккаунта перечислены основные конечные точки, у каждой есть кнопка копирования:

#Шаг 1: активация сервиса

1. Войдите в консоль и откройте LLM API → Обзор аккаунта (/llm/account).
2. При первом посещении на странице указано, что сервис не активирован. Нажмите Подключить сейчас.
3. После активации на странице появятся данные учётной записи, статистика использования, графики и информация об API.

#Шаг 2: пополнение квоты

При вызовах моделей расходуется квота вашей учётной записи LLM. Пополнить её можно двумя способами:

• Перевод с основного баланса: на карточке Текущий баланс страницы «Обзор учётной записи» нажмите Перевести, введите сумму и нажмите Подтвердить перевод. Минимальная сумма перевода — 1; в диалоговом окне показано, какую квоту вы получите.
• Код пополнения: если у вас есть код, введите его в карточке Пополнить по коду и нажмите Активировать.

Чтобы сначала пополнить основной баланс, нажмите Пополнить на карточке «Текущий баланс». Откроется раздел Биллинг → Баланс (/billing/balance).

#Шаг 3: создание API-ключа

1. Откройте LLM API → API-токены (/llm/tokens).
2. Нажмите Создать ключ в правом верхнем углу.
3. Введите Название. Это обязательное поле. Остальные параметры можно оставить по умолчанию: группа по умолчанию, без ограничений по моделям и IP-адресам, без срока действия. Описание каждого параметра см. в разделе API-ключи, квота и использование.
4. Нажмите Создать. Когда откроется диалоговое окно «Новый ключ создан», скопируйте полный ключ, начинающийся с sk-.

#Шаг 4: выбор модели

Посмотрите названия моделей и цены в разделе LLM API → Модели и цены (/llm/models) или выполните запрос к API:

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

В примерах ниже используется gpt-4o-mini. Доступность модели зависит от группы вашего ключа и текущего предложения платформы. Проверьте страницу «Модели» и замените название модели на нужное.

#Шаг 5: отправка запроса

#curl

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": "You are a helpful assistant."},
      {"role": "user", "content": "Introduce yourself in one sentence."}
    ]
  }'

Для потоковой передачи ответа добавьте "stream": true в тело запроса. Ответ будет поступать частями в виде Server-Sent Events (SSE).

#Python (openai SDK)

Сначала установите SDK: pip install openai.

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": "Introduce yourself in one sentence."}],
)
print(resp.choices[0].message.content)

# Streaming
stream = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Write a four-line poem."}],
    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.

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: "Introduce yourself in one sentence." }],
});
console.log(resp.choices[0].message.content);

#Пример получения векторных представлений

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 → Журнал запросов, чтобы посмотреть модель, количество входных и выходных токенов и стоимость. Подробнее см. в разделе API-ключи, квота и использование.

#Устранение неполадок

• 401 с сообщением «токен не передан»: убедитесь, что заголовок имеет точный вид Authorization: Bearer sk-..., с одним пробелом после Bearer.
• Недостаточно квоты: исчерпана квота учётной записи или лимит квоты ключа. Для учётной записи переведите дополнительную квоту или активируйте код пополнения. Для ключа увеличьте лимит или включите неограниченную квоту в разделе «API-ключи».
• Модель недоступна: модель не входит в группу вашего ключа или исключена ограничениями ключа по моделям. Проверьте страницу «Модели» либо выберите другую группу или модель.
• Запрос отклонён, у ключа задано ограничение по IP: убедитесь, что исходящий IP-адрес вашего сервера есть в списке разрешённых.
• Сторонние клиенты: выберите тип провайдера «Совместимый с OpenAI», задайте адрес https://llm.yeap.cloud/v1 и вставьте ключ sk-.... Некоторые клиенты ожидают только https://llm.yeap.cloud и добавляют /v1 самостоятельно.