Открытый REST API: генерируйте картинки в Nano Banana 2.1, GPT Image 2.6 и 2.5 из своих сервисов, ботов и скриптов. Вход по личному ключу, оплата кредитами вашего баланса, работает из России без VPN.
import time, requests
API = "https://riflect.ru/api/v1"
HEADERS = {"Authorization": "Bearer rfl_ваш_ключ"}
job = requests.post(f"{API}/images/generations", headers=HEADERS, json={
"model": "gpt-2-5-flare",
"prompt": "Логотип кофейни «Зерно», плоский стиль",
"background": "transparent",
}).json()["data"][0]
while job["status"] == "pending":
time.sleep(3) # картинка обычно готова за 10–40 секунд
job = requests.get(f"{API}/generations/{job['id']}", headers=HEADERS).json()
print(job["images"] if job["status"] == "succeeded" else job["error"])
Ключи
Каждый запрос передаёт личный ключ в заголовке Authorization: Bearer rfl_…
Ключ создаётся в блоке «Ваши ключи» ниже (он общий для API и MCP) и виден один раз. Генерации списывают кредиты с баланса владельца ключа. Удалённый ключ перестаёт работать сразу, при смене пароля отключаются все ключи. Не вставляйте ключ в код сайта или приложения, который видят пользователи: вызывайте API со своего сервера.
Ваши ключи
Ключ общий для API и MCP. Он даёт доступ к вашему балансу и работам: храните его на своём сервере и не публикуйте.
Статусы
Поле status в ответе запуска, GET /generations/{id} и в вебхуке.
pending
Работа в очереди, генерируется или мы копируем готовый файл в хранилище. Ссылок ещё нет.
succeeded
Готово: в поле images ссылки на файлы.
failed
Не получилось: причина в поле error, кредиты за работу уже вернулись на баланс.
Статус меняется только из pending в succeeded или failed. Сервер всегда отвечает сразу текущим статусом: если работа ещё идёт, спросите снова через несколько секунд.
Методы
POST /images/generations
Запуск генерации картинок. Кредиты списываются сразу, ответ 201 приходит без ожидания результата: в data столько работ, сколько вариантов просили (n), у каждой свой id. Поля запроса общие для всех моделей, допустимые значения у каждой модели свои (раздел «Модели»).
{
"id": "3f0c2a8e-5b1d-4a57-9d0e-1c2b3a4d5e6f",
"status": "failed",
"model": "nano-banana-2-1",
"credits": 4,
"created_at": "2026-11-16T12:00:00+00:00",
"error": "Запрос не прошёл проверку содержимого. Измените описание или фото и попробуйте снова. Кредиты возвращены"
}
GET /models
Модели API с ценами в кредитах по разрешению, форматами кадра, числом фото-референсов и параметрами. Те же данные, что в разделе «Модели», в машинном виде.
Секрет подписи вебхуков вашего аккаунта (создаётся при первом запросе). POST /webhook-secret/rotate выдаёт новый, старый перестаёт подходить сразу.
Ответ 200
{ "secret": "whsec_…" }
Модели
Цена указана за одну картинку в кредитах. Другие модели Riflect появятся в API позже.
Nano Banana 2.1
nano-banana-2-1
Быстрая и недорогая модель Google. Хорошо держит лицо и детали с фото-референсов, подходит для правки фото, вариаций и коллажей.
Цена за картинку
1K3 кредитов
2K4 кредитов
4K5 кредитов
Фото-референсы
до 10 в поле images
resolution
1K, 2K, 4K
aspect_ratio
auto1:12:33:21:44:13:44:34:55:41:88:19:1616:921:9
Параметры модели (в дополнение к общим полям)
output_format
Тип
string
По умолчанию
png
Значения
png, jpg
Описание
Формат файла результата.
Поле
Тип
Значения
По умолчанию
Описание
output_format
string
png, jpg
png
Формат файла результата.
auto: формат кадра модель выбирает сама.
Пример тела запроса POST /images/generations
{
"model": "nano-banana-2-1",
"prompt": "Та же девушка с фото, но в осеннем лесу, мягкий утренний свет",
"images": ["https://example.com/portrait.jpg"],
"aspect_ratio": "3:4",
"resolution": "2K",
"output_format": "jpg"
}
GPT Image 2.6 Flare
gpt-2-6-flare
Новая версия GPT Image от OpenAI. Точнее пишет текст, лучше собирает макеты и постеры, держит правки фото. Качество выбирается полем quality.
Вторая версия GPT Image 2.5: те же параметры и цена, другой характер картинки. Удобно сравнить с Flare на одном описании.
Цена за картинку
1K4 кредитов
2K6 кредитов
4K9 кредитов
Фото-референсы
до 16 в поле images
resolution
1K, 2K, 4K
aspect_ratio
auto1:13:22:34:33:416:99:1621:927:1616:279:88:9
Параметры модели (в дополнение к общим полям)
background
Тип
string
По умолчанию
auto
Значения
auto, opaque, transparent
Описание
Фон картинки. transparent даёт PNG без заднего плана (логотипы, стикеры, предметы для вырезки).
Поле
Тип
Значения
По умолчанию
Описание
background
string
auto, opaque, transparent
auto
Фон картинки. transparent даёт PNG без заднего плана (логотипы, стикеры, предметы для вырезки).
Форматы 27:16, 16:27, 9:8 и 8:9 модель делает только в 1K: для них resolution игнорируется, а цена берётся как за 1K.
С фото-референсами модель правит или перерисовывает их по описанию, без них рисует с нуля.
Пример тела запроса POST /images/generations
{
"model": "gpt-2-5-sunburst",
"prompt": "Постер фестиваля уличной еды, крупная надпись «ВКУСНО», яркие цвета",
"aspect_ratio": "2:3",
"resolution": "2K"
}
Вебхуки
Чтобы не опрашивать статус, передайте callback_url при запуске.
Когда работа закончится (succeeded или failed), сервер отправит POST на callback_url. Тело такое же, как ответ GET /generations/{id}, плюс поле event: generation.succeeded или generation.failed. При n больше 1 уведомление приходит по каждой работе отдельно.
Ответьте любым кодом 2xx в течение 10 секунд, тело ответа не читается. Если получатель недоступен или ответил не 2xx, отправка повторяется через 30 секунд, 2, 10, 30 и 60 минут, всего шесть попыток. Перенаправления не выполняются.
Одно уведомление может прийти повторно (например, если ваш сервер ответил слишком поздно): заголовок X-Riflect-Delivery у повторов тот же, по нему удобно отбрасывать дубли.
Подпись это HMAC-SHA256 секретом аккаунта (GET /webhook-secret) от строки «X-Riflect-Timestamp, точка, тело запроса как есть». Проверяйте её до разбора JSON и отклоняйте старые уведомления: так подделать или повторить чужой запрос не выйдет.
import hashlib, hmac, time
SECRET = "whsec_…" # GET /v1/webhook-secret
def verify(headers, raw_body: bytes) -> bool:
ts = headers["X-Riflect-Timestamp"]
if abs(time.time() - int(ts)) > 300: # старше 5 минут: не принимаем
return False
expected = hmac.new(SECRET.encode(), ts.encode() + b"." + raw_body, hashlib.sha256).hexdigest()
return hmac.compare_digest(headers["X-Riflect-Signature"], "sha256=" + expected)