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

Единый workflow для всех доступных image-моделей: выбор модели, запрос, ответ и стоимость.

Доступные image-модели

0.5K

0,045 $ / изображение

1K

0,067 $ / изображение

2K

0,101 $ / изображение

4K

0,151 $ / изображение

image input

8,00 $ / 1 млн токенов

cached image input

2,00 $ / 1 млн токенов

generated image output

30,00 $ / 1 млн токенов

image input

8,00 $ / 1 млн токенов

cached image input

2,00 $ / 1 млн токенов

generated image output

30,00 $ / 1 млн токенов

per generation request

0,02 $ / изображение

1K

0,06 $ / изображение

2K

0,08 $ / изображение

image input

2,00 $ / 1 млн токенов

generated image output

120,00 $ / 1 млн токенов

image input

2,00 $ / 1 млн токенов

generated image output

120,00 $ / 1 млн токенов

image input

0,50 $ / 1 млн токенов

generated image output

60,00 $ / 1 млн токенов

Запрос

POST /v1/images/generations. Path и optional параметры взяты из verified контракта выбранной модели.

curl -sS https://api.oneprovider.dev/v1/images/generations \
-H "Authorization: Bearer $ONEPROVIDER_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "A quiet observatory above the clouds",
"size": "1024x1024",
"quality": "low"
}'

Параметры зависят от модели

Размеры, quality, прозрачность, редактирование и формат ответа поддерживаются не всеми моделями одинаково. Не копируйте параметры одной модели в другую без проверки.

Ответ

Синхронный transport возвращает изображение или URL сразу. Асинхронный transport возвращает job id: опрашивайте status path, затем скачивайте content path.

Цена

В таблице моделей token pricing разложен по отдельным колонкам, а media billing показывает цену за изображение или другую единицу конкретной модели. Открыть pricing .

Быстрые ответы

Какой base URL использовать?

Claude Code и Anthropic SDK работают с https://api.oneprovider.dev. OpenAI SDK и OpenAI-совместимые клиенты работают с https://api.oneprovider.dev/v1. За обоими адресами один ключ; список моделей: странице моделей , ставки на странице тарифов .

Как авторизоваться?

Передайте сырой ключ sk-… в заголовке x-api-key или Authorization: Bearer: один из двух, не оба. Храните ключ в переменной окружения, а не в файле, который попадает в репозиторий. Подробнее об аутентификации .

Где взять ключ?

Откройте кабинет в Telegram-боте @oneprovider_robot или на app.oneprovider.dev, пополните баланс и нажмите «Выпустить ключ». У каждого ключа может быть свой лимит расхода. Кабинет и ключи .

Что значат ошибки 401, 404 и 429?

401: ключ не задан, написан с ошибкой или передан не в том заголовке; вставьте ключ целиком, без кавычек и пробелов. 404: обычно неверный base URL, например лишний или двойной /v1. 429 с текстом «Insufficient balance»: баланс кабинета или лимит ключа исчерпан, пополните его вместо повторов; любой другой 429 это лимит частоты, подождите Retry-After. Разбор: коды ошибок и решение проблем .

Почему обрывается стрим или сбрасывается соединение?

VPN и VLESS-прокси часто буферизуют SSE или ломают согласование HTTP/2. У OneProvider нет региональных ограничений, и стримы на нашей стороне не буферизуются: отключите прокси и повторите запрос.

Куда писать, если не помогло?

Напишите в Telegram @Oneproviderhelpbot или откройте «Поддержку» в веб-кабинете: приложите код статуса и точный текст ошибки. Как работает поддержка .