Документация

ForgetAPI Справочник

Единый OpenAI-совместимый API к текстовым моделям, генерации изображений и работе с речью. Подключение — стандартным OpenAI SDK: меняете базовый URL и ключ, остальной код остаётся прежним.

Набор моделей обновляется: новые появляются, устаревшие уходят. Поэтому в примерах ниже стоят модели, которые есть в API прямо сейчас, а полный список — в GET /v1/models и в каталоге моделей.

Чат и стриминг через OpenAI SDK

Изображения во входе запроса

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

Озвучка и распознавание речи

MCP: модели с внешними инструментами

Формат Anthropic Messages

Начало Работы

Получение API Ключа

Получите ваш API ключ через личный кабинет на platform.forgetapi.ru

Базовый URL

Используйте https://api.forgetapi.ru/v1 в качестве базового URL для всех запросов. Ключ передаётся в заголовке Authorization: Bearer …, X-Api-Key или api-key.

Баланс и Тарифы

Система работает по модели Pay-As-You-Go (PAYG) — без подписки, оплата по факту использования. Стоимость списывается с рублёвого баланса после каждого запроса. Для запроса на балансе должно быть не меньше 30 ₽.

Тарифные уровни (Tier)

Уровень определяется суммой всех пополнений и меняет только лимит запросов в минуту (RPM). Все модели доступны на любом уровне.

Уровень	Пополнения от	RPM
Tier 0	0 ₽	10
Tier 1	200 ₽	20
Tier 2	500 ₽	30
Tier 3	1 000 ₽	80
Tier 4	5 000 ₽	150
Tier 5	10 000 ₽	300

Те же данные без ключа — GET /v1/tiers.

Чат (Chat Completions)

Базовый Запрос

Отправьте текстовый запрос к ИИ модели используя OpenAI SDK

python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.forgetapi.ru/v1",
    api_key="ваш_forgetapi_ключ"
)

response = client.chat.completions.create(
    model="claude-opus-5",
    messages=[
        {"role": "user", "content": "Привет! Как дела?"}
    ]
)

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

Стриминг Ответов

Получайте ответы частями в режиме реального времени

python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.forgetapi.ru/v1",
    api_key="ваш_ключ"
)

stream = client.chat.completions.create(
    model="claude-opus-5",
    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="")

Изображения во Входе

Большинство моделей принимают картинки: передайте её в content как image_url — ссылкой или в base64

python

from openai import OpenAI
import base64

client = OpenAI(
    base_url="https://api.forgetapi.ru/v1",
    api_key="ваш_ключ"
)

# Загрузка изображения
with open("image.jpg", "rb") as f:
    image_data = base64.b64encode(f.read()).decode()

response = client.chat.completions.create(
    model="claude-opus-5",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "Что на этом изображении?"},
                {
                    "type": "image_url",
                    "image_url": {
                        "url": f"data:image/jpeg;base64,{image_data}"
                    }
                }
            ]
        }
    ]
)

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

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

Создание Изображений

python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.forgetapi.ru/v1",
    api_key="ваш_ключ"
)

response = client.images.generate(
    model="nano-banana-2",
    prompt="Футуристический город на закате",
    size="1024x1024",
    n=1
)

image_url = response.data[0].url
print(f"Изображение: {image_url}")

Ссылка живёт 3 часа

Сохраните картинку, если она нужна дольше. Нужен файл сразу в ответе — передайте response_format="b64_json".

Редактирование с Reference Image

Модель nano-banana поддерживает редактирование на основе референсных изображений

python

from openai import OpenAI
import base64

client = OpenAI(
    base_url="https://api.forgetapi.ru/v1",
    api_key="ваш_ключ"
)

# Загружаем референсное изображение
with open("reference.jpg", "rb") as f:
    ref_image = base64.b64encode(f.read()).decode()

response = client.images.generate(
    model="nano-banana",
    prompt="Добавь закат на фоне",
    extra_body={
        "reference_images": [f"data:image/jpeg;base64,{ref_image}"],
        "temperature": 0.7
    }
)

print(response.data[0].url)

То же через OpenAI-совместимый POST /v1/images/edits (multipart): до 4 картинок в одном запросе.

Аудио (TTS / STT)

Text-to-Speech (TTS)

Преобразуйте текст в речь с помощью модели reserve/inworld-tts-1.5-max

python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.forgetapi.ru/v1",
    api_key="ваш_ключ"
)

with client.audio.speech.with_streaming_response.create(
    model="reserve/inworld-tts-1.5-max",
    voice="Galina",
    input="Привет! Это пример синтеза речи через ForgetAPI.",
    response_format="mp3"
) as response:
    response.stream_to_file("output.mp3")

Голоса

voice — голос Inworld, например Galina. Список голосов — GET https://api.forgetapi.ru/voices/v1/voices с вашим ключом. Форматы: mp3, opus, wav, pcm; текст — до 2000 символов.

Speech-to-Text (STT)

Транскрибируйте аудио в текст с помощью модели whisper-large-v3

python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.forgetapi.ru/v1",
    api_key="ваш_ключ"
)

with open("recording.mp3", "rb") as audio_file:
    transcript = client.audio.transcriptions.create(
        model="whisper-large-v3",
        file=audio_file
    )

print(transcript.text)

Ограничение файла

Максимальный размер аудиофайла — 25 MB. Поддерживаемые форматы: mp3, mp4, mpeg, mpga, m4a, wav, webm.

Перевод речи на английский — POST /v1/audio/translations с теми же параметрами.

MCP Агенты

Что такое MCP?

Model Context Protocol (MCP) позволяет ИИ моделям использовать внешние инструменты: веб-скрапинг, работа с базами данных, выполнение кода и многое другое.

Подключаются серверы из списка на странице MCP в кабинете — там готовый конфиг для каждого. Ключи самих сервисов (например, FIRECRAWL_API_KEY) передаются в env.

Пример: Веб-скрапинг с Firecrawl

python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.forgetapi.ru/v1",
    api_key="ваш_forgetapi_ключ"
)

response = client.chat.completions.create(
    model="gpt-5.6-terra",
    messages=[
        {
            "role": "user",
            "content": "Просканируй сайт https://firecrawl.dev и расскажи о функциях."
        }
    ],
    extra_body={
        "mcp_config": {
            "mcpServers": {
                "firecrawl": {
                    "command": "npx",
                    "args": ["-y", "firecrawl-mcp"],
                    "env": {
                        "FIRECRAWL_API_KEY": "ваш_firecrawl_ключ"
                    }
                }
            }
        },
        "max_steps": 10,
        "memory_enabled": True
    }
)

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

Параметры

max_steps — сколько шагов может сделать агент, по умолчанию 25
memory_enabled — память агента между шагами, по умолчанию включена
timeout — сколько секунд ждать ответа агента, по умолчанию 900

API-пакеты

Пакет — предоплаченный объём токенов на срок. Покупается в кабинете, в разделе «API пакеты». К покупке выдаётся отдельный ключ fgt-pkg-…, а адрес тот же — https://api.forgetapi.ru/v1.

Как работает ключ пакета

Только чат: /v1/chat/completions и /anthropic/v1/messages
GET /v1/models с этим ключом покажет модели пакета
Расход идёт из токенов пакета — баланс не списывается
Срок истёк или пакет отключён — ответ 403, токены закончились — 429

Биллинг

Как рассчитывается стоимость

ForgetAPI использует модель Pay-As-You-Go: вы оплачиваете только то, что фактически использовали. Никаких подписок и скрытых платежей.

Цены моделей указаны в долларах и списываются с рублёвого баланса по текущему курсу: $1 (84,99 ₽).

Принцип оплаты

Input-токены — токены вашего запроса к модели
Output-токены — токены ответа, включая рассуждения (reasoning)
Кэшированные токены — часть запроса из кэша, по своей цене вместо обычной цены входа
Картинки, аудио, озвучка — за изображение, за минуту записи, за 1000 символов
Длинный контекст — у некоторых моделей запрос длиннее порога стоит дороже, это указано в каталоге моделей
Тарификация — списывается только по факту использования, баланс не сгорает

Цены и пополнение

Цены всех моделей — в GET /v1/models и в каталоге моделей. Баланс пополняется в личном кабинете удобным для вас способом и хранится на счёте до полного использования.

Справочник API

POST/v1/chat/completions

Отправка сообщений к ИИ

POST/v1/images/generations

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

POST/v1/images/edits

Правка изображений, до 4 картинок

POST/v1/audio/speech

Text-to-Speech

POST/v1/audio/transcriptions

Speech-to-Text

POST/v1/audio/translations

Перевод речи на английский

POST/anthropic/v1/messages

Формат Anthropic Messages

GET/v1/models

Модели с ценами, без ключа

GET/v1/tiers

Уровни RPM, минимальный баланс и курс, без ключа

Anthropic SDK

Для формата Anthropic базовый URL — https://api.forgetapi.ru/anthropic, ключ тот же. Ключ можно передать в Authorization: Bearer …, X-Api-Key или api-key.

Ошибки и Лимиты

Коды Ошибок

400Неверный запрос или такой модели нет
401Неверный API ключ
403Ключ отключён или ключ пакета не подходит для запроса
413Аудиофайл больше 25 MB
429Превышен RPM или баланс ниже минимума — причина в тексте ошибки
500Ошибка сервера
502Поставщик модели ответил ошибкой
504Таймаут (модель не ответила)

Системные Лимиты

RPM зависит от Tier (10–300 запросов/мин)
Минимальный баланс для запроса: 30 ₽
Аудио файлы: макс 25 MB
Озвучка: до 2000 символов за запрос
Ссылка на изображение: 3 часа
MCP: до 25 шагов и 900 сек по умолчанию

Формат Ошибки

json

{
  "error": {
    "message": "Model not found: 'old-model'. Check /v1/models for available models.",
    "type": "api_error",
    "code": 400
  }
}

Code Preview

Установка и Настройка

from openai import OpenAI

# Инициализация клиента
client = OpenAI(
    base_url="https://api.forgetapi.ru/v1",
    api_key="ваш_ключ_из_кабинета"
)

PRO TIP

Библиотека OpenAI для Python полностью совместима с нашим API. Просто измените base_url.