• Основные концепции API
• Примеры кода (Python, CURL, Google Colab и пр.)
• Опенсорс примеры (RAG, телеграм-бот и пр.)
• Решение проблем API и список ошибок
• Особенности реализации API
• Дополнительные возможности (Tools, MCP и пр.)

Совместимое API

ОСНОВНОЕ OpenAI-совместимое API

В первую очередь мы поддерживаем только часть OpenAI API, касающуюся текстовых нейросетей – зато для самых разных нейросетей (v1/chat/completions).

Также мы поддерживаем

• v1/embeddings – модель для создания текстовых эмбеддингов
• v1/chat/completions для vision-нейросетей
• v1/images/generations, v1/images/edit – генерации картинок,
• v1/audio/transcriptions (speech to text)
• v1/audio/speech – генерации голоса (TTS),

Эндпойнт с НАШЕЙ (не OpenAI) реализацией:

• v1/video/generate – генерация видео. Он разрабатывался до Sora 2, которая предложила API для генерации видео.

В планах поддержка:

• поискового API (не OpenAI)

Нет планов на поддержку:

• v1/assistants кастомных ассистенты и пр. – но вы можете использовать наш пример реализации RAG (поиска по документам), если вам нужна такая функциональность.
• v1/responses

Мы не поддерживаем

• решения с сайта OpenAI (хотя для них есть аналоги)

Кастомные точки доступа API (баланс аккаунта, текст из PDF/DOCX, генерация видео)

Поддерживается:

• v1/balance – получение баланса и статуса аккаунта пользователя
• v1/extract_text – получение текста из PDF/DOCX, включая OCR при необходимости
• v1/video/generate – для генерации видео (долгая)

Stable Diffusion API (A1111, Automatic)

Поддерживается:

• sdapi/v1/txt2img – генерация изображений

Полный адрес вызова: https://api.vsegpt.ru/sdapi/<ваш_api_ключ>/sdapi/v1/txt2img

При вызове будет вызвана модель sdapi/txt2img – её по умолчанию не существует, надо вручную установить её существование в маппинге. Маппинг настраивается в Настройках пользователя

Например:
sdapi/txt2img=img-stable/stable-diffusion-xl-lightning

Пример использования в приложении: https://vsegpt.ru/ExtTools/AIRoguelite#imggen

Anthropic-совместимое API (бета)

Позволяет использовать Claude Code с любыми моделями VseGPT


Anthropic-совместимое API позволяет делать запросы к любым моделям VseGPT. Поддерживается как стриминговый режим, так и нестриминговый.

Про настройку Claude Code: https://vsegpt.ru/ExtTools/ClaudeCode

Пример кода для прямого вызова:

import requests
import json

# Настройки
API_URL = "https://services.vsegpt.ru:3000/v1/messages" 
API_KEY = "sk-or-v...."  # Ваш VseGPT API ключ

# Формируем запрос в формате Anthropic API
data = {
    "model": "openai/gpt-4o-mini",  # или другая модель
    "max_tokens": 1024,
    "messages": [
        {
            "role": "user",
            "content": "Перечисли числа от 1 до 5"
        }
    ]
}
# Заголовки
headers = {
    "Content-Type": "application/json",
    "X-Api-Key": API_KEY,
}
# Отправляем запрос
response = requests.post(API_URL, headers=headers, json=data)
# Проверяем статус
if response.status_code == 200:
    result = response.json()

    # Извлекаем текст ответа
    if result.get("content"):
        text = result["content"][0]["text"]
        print("Ответ модели:")
        print(text)
        print("\n" + "=" * 50)
        print("Полный ответ:")
        print(json.dumps(result, indent=2, ensure_ascii=False))
    else:
        print("Ошибка: нет content в ответе")
        print(json.dumps(result, indent=2, ensure_ascii=False))
else:
    print(f"Ошибка: {response.status_code}")
    print(response.text)

Механика доступа по API и URL для подключений

Поддерживается стандартный доступ по API OpenAI – вы можете использовать любые программы для доступа по нему.

Не забудьте указать следующие кастомные параметры – URL точки доступ и имя модели:

URL: https://api.vsegpt.ru/v1/chat/completions

• В зависимости от программы, это может быть https://api.vsegpt.ru/v1 или ещё что-то, см. примеры в Руководстве по подключению сторонних инструментов

также поддерживается старый URL на другом порту https://api.vsegpt.ru:6070/, который можно увидеть в некоторых примерах подключения

model: id модели из списка моделей

• Вы можете поменять только ID модели при запросе и перенаправить запрос к Antropic Claude, Google или опенсорс моделям, не меняя остальные поля в запросе. Мы поддерживаем единый интерфейс для всех моделей.
• Допускается указание стандартных идентификаторов gpt-3.5-turbo, gpt-4 – они будут автоматически преобразованы в соответствующие полные ID моделей OpenAI в большинстве случаев.
• Также возможно автоматическое преобразование ваших моделей в новые идентификаторы, если вы настроите маппинг моделей в Настройках

Важно: при автоматизации следуйте Правилам хорошего бота, чтобы избежать блокировки