GPT4Free (g4f) - инструмент, предоставляющий доступ к моделям GPT-4/5, Claude, Gemini, DeepSeek через обратную инженерию публичных API.

⚠️ Важно: только для обучения и тестов. Может нарушать правила некоторых сервисов.


Установка

Требования

  • Компьютер с интернетом
  • Python 3.10+ (при установке отметить “Add to PATH”)

Команда установки

pip install -U g4f[all]

Запуск

Вариант 1: Веб-интерфейс

python -m g4f.cli gui --port 8080

Интерфейс: http://localhost:8080/chat/

Вариант 2: Локальный API

python -m g4f --port 1337

После запуска к API можно подключать приложения, поддерживающие OpenAI API.


Первый скрипт

Создать файл test.py:

from g4f.client import Client

client = Client()

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Почему картофель - это состояние души?"}]
)

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

Запуск:

python test.py

Генерация изображений

from g4f.client import Client

client = Client()

img = client.images.generate(
    model="flux",
    prompt="Киберпанк-картофель в неоновом городе",
    response_format="url"
)

print(f"Готово: {img.data[0].url}")

Актуальные модели (март 2026)

МодельСтатусНазначение
gpt-4o-mini✅ СтабильноБыстрые ответы, чат
gpt-4o✅ СтабильноСложные задачи
deepseek-v3✅ СтабильноКод, логика, математика
gemini-2.5-pro⚠️ НестабильноМультимодальные задачи
llama-3.3-70b✅ СтабильноОткрытая альтернатива
gpt-5🔶 ЭкспериментМожет не работать

💡 Список меняется. Актуальный список - через веб-интерфейс или запрос: GET http://localhost:8080/backend-api/models


Подключение к OpenAI-совместимым приложениям

После запуска python -m g4f --port 1337:

from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:1337/v1",
    api_key="не-важно-что-здесь"  # можно любое значение
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Расскажи анекдот про картофель"}]
)

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

Совместимо с LibreChat, Flowise, AnythingLLM и другими.


Диагностика

# Обновить библиотеку
pip install -U g4f

# Ошибка при установке на Windows
pip install --upgrade pip setuptools wheel

# Модель не отвечает
# → Использовать другую модель
# → Включить VPN
# → Подождать 10-30 секунд (некоторые провайдеры медленные)

# При использовании Docker добавить памяти браузеру:
docker run -p 8080:8080 --shm-size="2g" hlohaus789/g4f:latest

Docker

docker run -p 8080:8080 --shm-size="2g" hlohaus789/g4f:latest
  • Веб-интерфейс: http://localhost:8080
  • API: http://localhost:8080/v1

Ссылки