WaveSpeed LLM API: Быстрый старт — эндпоинт, ключ API и совместимость с OpenAI

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

By WaveSpeedAI 5 min read
WaveSpeed LLM API: Быстрый старт — эндпоинт, ключ API и совместимость с OpenAI

Просматривайте 90+ LLM на WaveSpeedAI — Claude, GPT, Gemini, Qwen, DeepSeek, Llama, Grok, Mistral и другие через единый OpenAI-совместимый эндпоинт. Каталог LLM → · Playground →

Три поля, которые нужно заполнить

Когда вы подключаете нового провайдера LLM к чат-приложению, SDK или IDE, вас почти всегда спрашивают одно и то же:

  1. Эндпоинт / Base URL — где находится API.
  2. API-ключ — как провайдер вас идентифицирует.
  3. Протокол чата — OpenAI Chat Completions, Anthropic Messages или что-то иное.

Для WaveSpeed LLM ответы просты:

ПолеЗначение
Base URLhttps://llm.wavespeed.ai/v1
API-ключВаш API-ключ WaveSpeed (из личного кабинета)
ПротоколOpenAI Chat Completions (совместим с OpenAI SDK)

Всё. Если инструмент поддерживает «пользовательский OpenAI-совместимый эндпоинт», WaveSpeed LLM работает.

Что такое WaveSpeed LLM?

WaveSpeed LLM — это единый API, который предоставляет доступ к 90+ языковым моделям от 30+ провайдеров через один OpenAI-совместимый эндпоинт — Claude Opus 4.6, GPT-5.2, Gemini 3, DeepSeek, Llama 4, Qwen 3, Grok 4, Mistral и другие. Один API-ключ, один Base URL, один формат запросов.

Без холодных стартов. Оплата за токены. Без подписок. Бесплатный уровень для начала.

Шаг 1: Получите API-ключ

  1. Перейдите на wavespeed.ai и войдите в аккаунт (Google или email).
  2. Откройте личный кабинет и найдите раздел API Keys.
  3. Создайте новый ключ — он выглядит как длинная случайная строка. Скопируйте его сразу и сохраните в надёжном месте.

Относитесь к этому ключу как к паролю. Не добавляйте его в git, не вставляйте в скриншоты.

Шаг 2: Укажите Base URL

LLM API находится по адресу:

https://llm.wavespeed.ai/v1

Эндпоинт Chat Completions, соответственно:

https://llm.wavespeed.ai/v1/chat/completions

Везде, где инструмент запрашивает «OpenAI Base URL», «API Endpoint» или «Custom Server URL», вставляйте https://llm.wavespeed.ai/v1.

Шаг 3: Выберите модель

Идентификаторы моделей используют формат vendor/model. Несколько популярных:

ID моделиПримечания
deepseek/deepseek-v4-flashОткрытые веса, сильное кодирование

Полный каталог доступен на wavespeed.ai/llm.

Шаг 4: Сделайте первый запрос

Python (OpenAI SDK)

import os
from openai import OpenAI, OpenAIError

api_key = os.getenv("WAVESPEED_API_KEY")
if not api_key:
    raise RuntimeError("Set WAVESPEED_API_KEY before running this example")

client = OpenAI(
    base_url="https://llm.wavespeed.ai/v1",
    api_key=api_key,
    timeout=120.0,
    max_retries=2,
)

# The SDK sends this request to https://llm.wavespeed.ai/v1/chat/completions.
try:
    response = client.chat.completions.create(
        model="deepseek/deepseek-v4-flash",
        messages=[{"role": "user", "content": "Hello!"}],
    )
    print(response.choices[0].message.content or "")
except OpenAIError as exc:
    raise SystemExit(f"LLM request failed: {exc}") from exc

Node.js (OpenAI SDK)

import OpenAI from 'openai';

if (!process.env.WAVESPEED_API_KEY) throw new Error('Set WAVESPEED_API_KEY');

const client = new OpenAI({
  apiKey: process.env.WAVESPEED_API_KEY,
  baseURL: 'https://llm.wavespeed.ai/v1',
  timeout: 120_000,
  maxRetries: 2
});

try {
  const response = await client.chat.completions.create({
    model: 'deepseek/deepseek-v4-flash',
    messages: [{ role: 'user', content: 'Hello!' }]
  });
  console.log(response.choices[0]?.message?.content ?? '');
} catch (error) {
  console.error('LLM request failed:', error);
  process.exitCode = 1;
}

curl

curl --fail-with-body --connect-timeout 10 --max-time 120 --retry 2 --retry-all-errors \
  https://llm.wavespeed.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -d '{
    "model": "deepseek/deepseek-v4-flash",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Обратите внимание: единственные отличия от прямого обращения к OpenAI — base_url и строка model. Весь остальной существующий код для OpenAI работает без изменений.

Стриминг, инструменты и Vision

Всё, что работает на эндпоинте Chat Completions OpenAI, работает и на WaveSpeed LLM:

  • stream: true для стриминга через server-sent events.
  • tools и tool_choice для вызова функций (на поддерживающих моделях).
  • response_format: { type: "json_object" } для JSON-режима.
  • Передача изображений через content: [{ type: "image_url", image_url: { url: "..." } }] на моделях с поддержкой vision.

Поскольку протокол идентичен, любая библиотека или фреймворк, основанный на OpenAI, — LangChain, LlamaIndex, Vercel AI SDK, Haystack — работает при простой замене Base URL.

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

«Invalid API key» / ошибки 401 Убедитесь, что используете API-ключ из личного кабинета WaveSpeed, а не от OpenAI или другого провайдера. Заголовок должен быть Authorization: Bearer <key>.

«Model not found» / ошибка 404 для модели Идентификаторы моделей чувствительны к регистру и должны включать префикс провайдера. Используйте deepseek/deepseek-v4-flash, а не claude-opus-4.6 и не Claude-Opus-4.6.

«Wrong protocol» Если инструмент предлагает выбрать между «OpenAI», «Anthropic», «Gemini» или другим вариантом — всегда выбирайте OpenAI. WaveSpeed LLM использует OpenAI Chat Completions для всех моделей, включая Claude и Gemini. Префикс провайдера в ID модели выбирает исходную модель; формат запроса остаётся совместимым с OpenAI.

Проблемы с сетью / подключением Эндпоинт — https://llm.wavespeed.ai/v1 — обратите внимание на поддомен llm. (не api.). Если ваш файервол блокирует пользовательские поддомены, добавьте llm.wavespeed.ai в список разрешённых.

Почему WaveSpeed LLM

  • Совместимость с OpenAI. Работает с каждым OpenAI SDK, LangChain, Vercel AI SDK и любым инструментом, поддерживающим пользовательский Base URL.
  • Без холодных стартов и подписок. Платите только за то, что используете, с прозрачным ценообразованием за токены.
  • Бесплатный уровень. Начните разрабатывать без банковской карты.

Начните разработку сегодня

Три поля — Base URL, API-ключ, протокол OpenAI — и вы готовы.

Получите API-ключ на wavespeed.ai/llm и сделайте первый запрос менее чем за пять минут.

Поделиться