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

ForgetAPI Справочник

Унифицированный интерфейс для ИИ моделей. Создавайте приложения с чатами, генерацией видео и изображений через единое API.

Claude 4.5 Sonnet, GPT-4o, Gemini 2.5 Pro
Veo 3.1 Генерация Видео (1080p)
Генерация и Редактирование Изображений
Аудио: Text-to-Speech и Speech-to-Text
MCP Агенты (Автоматизация)
Responses API (OpenAI-совместимый)

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

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

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

Базовый URL
Используйте https://api.forgetapi.ru/v1 в качестве базового URL для всех запросов

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

Система работает по модели Pay-As-You-Go (PAYG) — оплата по факту использования токенов. Цены указаны в рублях за 1 миллион токенов. Списание происходит автоматически после каждого запроса.

Тарифные уровни (Tier)
Уровень определяется суммой пополнений: Tier 0 (бесплатно, 3 RPM) → Tier 1 → Tier 2 → ... → Tier 5 (500 RPM). Чем выше Tier, тем больше лимит запросов в минуту и доступных моделей.

Tier 0-1

3-10 RPM
Базовые модели

Tier 2-3

20-50 RPM
Расширенные модели

Tier 4-5

100-500 RPM
Все модели

Чат (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="gpt-4o",
    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="gpt-4o",
    messages=[{"role": "user", "content": "Расскажи историю"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Загрузка Изображений

Анализируйте изображения с мультимодальными моделями

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="gpt-4o",
    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="flux-1.1-dev",
    prompt="Футуристический город на закате",
    size="1024x1024",
    n=1
)

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

Редактирование с 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)

Аудио (TTS / STT)

Text-to-Speech (TTS)

Преобразуйте текст в речь с помощью модели tts-1 или tts-1-hd

python
from openai import OpenAI

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

response = client.audio.speech.create(
    model="tts-1",
    voice="alloy",
    input="Привет! Это пример синтеза речи через ForgetAPI."
)

response.stream_to_file("output.mp3")

Speech-to-Text (STT)

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

python
from openai import OpenAI

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

audio_file = open("recording.mp3", "rb")

transcript = client.audio.transcriptions.create(
    model="whisper-1",
    file=audio_file
)

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

Responses API

Responses API — альтернативный формат запросов, совместимый с OpenAI Responses endpoint. Используйте POST /v1/responses вместо Chat Completions.

python
from openai import OpenAI

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

response = client.responses.create(
    model="gpt-4o",
    input="Объясни квантовые вычисления простым языком."
)

print(response.output_text)
Совместимость
Responses API поддерживает те же модели, что и Chat Completions. Формат ввода/вывода соответствует спецификации OpenAI Responses.

MCP Агенты

Что такое MCP?

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

Пример: Веб-скрапинг с 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-4o",
    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)

Биллинг

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

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

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

  • Input-токены — токены вашего запроса к модели
  • Output-токены — токены ответа, который сгенерировала модель
  • Тарификация — списывается только по факту использования, баланс не сгорает
Пополнение баланса
Пополняйте баланс в личном кабинете удобным для вас способом. Средства зачисляются мгновенно и хранятся на счёте до полного использования.

Справочник API

POST/chat/completions
Отправка сообщений к ИИ
POST/images/generations
Генерация изображений
POST/audio/speech
Text-to-Speech
POST/audio/transcriptions
Speech-to-Text
POST/responses
Responses API
GET/models
Список доступных моделей

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

Коды Ошибок

  • 401Неверный API ключ
  • 403Модель недоступна для вашего тарифа
  • 413Файл превышает максимальный размер
  • 429Превышен лимит запросов (RPM)
  • 500Ошибка сервера
  • 504Таймаут (модель не ответила)

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

  • RPM зависит от Tier (3-500 запросов/мин)
  • Видео: макс 8 секунд
  • Аудио файлы: макс 25 MB
  • Изображения: макс 100 MB
  • MCP таймаут: 300 сек