Документация Store API
Store API совместим с форматом OpenAI: если ваш код уже работает с OpenAI SDK, достаточно поменять базовый адрес и ключ. Один ключ обслуживает текстовые модели и генерацию изображений, списания идут с общего баланса.
Быстрый старт
Зарегистрируйтесь, скопируйте ключ вида sk-shop-… в личном кабинете и подставьте два значения:
from openai import OpenAI
client = OpenAI(
base_url="https://store-api.ru/v1",
api_key="sk-shop-...",
)
resp = client.chat.completions.create(
model="openai/gpt-4o-mini",
messages=[{"role": "user", "content": "Привет!"}],
)
print(resp.choices[0].message.content)Авторизация
Ключ передаётся заголовком Authorization: Bearer sk-shop-…. Ключей можно создать до десяти — под каждый проект свой, с отдельным названием и лимитом трат. Если ключ выбрал лимит или его отключили, запросы вернут ошибку, а остальные ключи продолжат работать.
Чат-запросы
Эндпоинт POST /v1/chat/completions — полный аналог OpenAI, включая потоковую передачу stream: true. Доступны модели OpenAI, Anthropic, Google и другие — идентификатор указывается в поле model.
curl https://store-api.ru/v1/chat/completions \
-H "Authorization: Bearer sk-shop-..." \
-H "Content-Type: application/json" \
-d '{
"model": "anthropic/claude-sonnet-5",
"messages": [{"role": "user", "content": "Напиши хайку про API"}]
}'Генерация изображений
Эндпоинт POST /v1/images/generations в формате OpenAI Images API. Стоимость фиксированная за картинку и списывается только при успешной генерации. Размер задаётся как 1024x1024 (стороны кратны 8) или готовым пресетом вроде square_hd.
curl https://store-api.ru/v1/images/generations \
-H "Authorization: Bearer sk-shop-..." \
-H "Content-Type: application/json" \
-d '{
"model": "fal-ai/flux/schnell",
"prompt": "красный спорткар на горном серпантине на закате",
"size": "1024x1024"
}'
# Ответ:
# {"created": 1786105709,
# "data": [{"url": "https://.../image.png"}]}Каталог моделей с ценами можно получить программно — GET-запросом на тот же адрес. Актуальные модели и цены:
| Модель | Цена | Назначение |
|---|---|---|
| google/nano-banana | 8 ₽ | Gemini 2.5 Flash Image. Правит ваши фото по тексту (передайте image в API) и держит текст на картинке. |
| google/gemini-3-pro-image | 28 ₽ | Старшая модель Google: сложные сцены, аккуратные детали и надписи. |
| openai/gpt-5-image | 41 ₽ | Генератор OpenAI: точно следует длинному описанию. |
| fal-ai/flux/schnell | 3 ₽ | Молниеносная генерация за пару секунд. Идеален для черновиков и превью. |
| fal-ai/flux/dev | 6 ₽ | Высокая детализация и точность по промпту. Баланс цены и качества. |
| fal-ai/flux-pro/v1.1 | 11 ₽ | Флагман FLUX: максимальное качество, фотореализм, сложные сцены. |
| fal-ai/recraft-v3 | 11 ₽ | Топ для дизайна: логотипы, иконки, векторные стили, текст на картинке. |
Озвучка текста
Эндпоинт POST /v1/audio/speech в формате OpenAI Audio API: в ответ приходит готовый аудиофайл. Цена считается по числу знаков в поле input и списывается только при успешной озвучке. Имена tts-1, tts-1-hd и голоса OpenAI (alloy, nova, onyx…) тоже принимаются — готовый код на OpenAI SDK менять не нужно.
curl https://store-api.ru/v1/audio/speech \
-H "Authorization: Bearer sk-shop-..." \
-H "Content-Type: application/json" \
-d '{
"model": "elevenlabs/eleven-v4-turbo",
"voice": "Sarah",
"input": "Привет! Это озвучка через API."
}' --output speech.mp3Список голосов каждой модели и форматы ответа отдаёт GET-запрос на тот же адрес. Модели и цены:
| Модель | За 1000 знаков | До, знаков | Назначение |
|---|---|---|---|
| inworld/tts-1.5-max | 2 ₽ | 2000 | Родные русские голоса по самой низкой цене. Файл WAV. |
| elevenlabs/eleven-v4-turbo | 8 ₽ | 5000 | Готово за пару секунд. Для роликов, ботов и черновиков. |
| elevenlabs/eleven-v4 | 16 ₽ | 5000 | Самая живая интонация. Для аудиокниг, рекламы и подкастов. |
| silero/v5-ru | 0.4 ₽ | 10000 | Самая дешёвая озвучка русского текста. Голос проще, чем у ElevenLabs: для черновиков, ботов и объявлений. |
Свой голос
Голос создаётся в студии, во вкладке «Голос» → «Мой голос»: нужна запись 15–30 секунд речи и подтверждение, что это ваш голос или у вас есть разрешение его владельца. После этого им можно озвучивать текст и по API — модель chatterbox/voice-clone, в поле voice передаётся id голоса из студии. Цена — 5 ₽ за 1000 знаков, до 1500 знаков за запрос, ответ в mp3.
curl https://store-api.ru/v1/audio/speech \
-H "Authorization: Bearer sk-shop-..." \
-H "Content-Type: application/json" \
-d '{
"model": "chatterbox/voice-clone",
"voice": "cv_0123456789abcdef01234567",
"input": "Этот текст прозвучит моим голосом."
}' --output speech.mp3Музыка и звуковые эффекты
Эндпоинт POST /v1/audio/generations создаёт музыку без вокала или звуковой эффект по текстовому описанию и возвращает ссылку на mp3-файл. Длительность задаётся полем duration в секундах; без него берётся длительность по умолчанию. Деньги списываются только за готовую запись.
curl https://store-api.ru/v1/audio/generations \
-H "Authorization: Bearer sk-shop-..." \
-H "Content-Type: application/json" \
-d '{
"model": "elevenlabs/sound-effects-v3",
"prompt": "гроза вдалеке, дождь стучит по окну",
"duration": 6
}'
# Ответ:
# {"created": 1794574000,
# "data": [{"url": "https://.../sound.mp3"}],
# "duration": 6, "cost_rub": 2.4}Каталог с ценами и границами длительности отдаёт GET-запрос на тот же адрес. Модели:
| Модель | Цена | Секунд | Назначение |
|---|---|---|---|
| stability/stable-audio-3-sfx | 4 ₽ за запись | 1–60 | Эффекты. Шумы, фоны и атмосфера до минуты по одной цене. |
| elevenlabs/sound-effects-v3 | 0,4 ₽ за секунду | 1–30 | Эффекты. Точные короткие эффекты: удары, шаги, интерфейс, природа. |
| stability/stable-audio-3-music | 5 ₽ за запись | 5–120 | Музыка. Фоновая музыка без вокала до двух минут по одной цене. |
| elevenlabs/music-v2.5 | 2 ₽ за секунду | 5–120 | Музыка. Студийное звучание: заставки, джинглы, треки для роликов. |
Список моделей
GET /v1/models возвращает полный каталог текстовых моделей в формате OpenAI. Цены на текстовые модели указаны в таблице тарифов и считаются за миллион токенов отдельно на вход и выход.
Коды ошибок
| Код | Что означает |
|---|---|
| 401 | Ключ не передан, неизвестен или отключён в кабинете. |
| 402 | Закончился баланс либо ключ выбрал свой лимит трат. Пополните баланс или поднимите лимит ключа. |
| 404 | Неизвестный идентификатор модели — сверьтесь со списком моделей. |
| 502 / 504 | Провайдер недоступен или не ответил вовремя. Запрос можно повторить, списания за неудачную генерацию не происходит. |
Частые вопросы
Какой базовый адрес у API?
https://store-api.ru/v1 — укажите его как base_url в любом OpenAI-совместимом SDK.
Нужен ли отдельный ключ для картинок?
Нет, работает тот же ключ и тот же баланс, что и для текстовых моделей.
Что означает ошибка 402?
Закончился баланс либо ключ выбрал назначенный ему лимит трат. Пополните баланс или поднимите лимит ключа в личном кабинете.