KeyMarket

Документация 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-banana8 ₽Gemini 2.5 Flash Image. Правит ваши фото по тексту (передайте image в API) и держит текст на картинке.
google/gemini-3-pro-image28 ₽Старшая модель Google: сложные сцены, аккуратные детали и надписи.
openai/gpt-5-image41 ₽Генератор OpenAI: точно следует длинному описанию.
fal-ai/flux/schnell3 ₽Молниеносная генерация за пару секунд. Идеален для черновиков и превью.
fal-ai/flux/dev6 ₽Высокая детализация и точность по промпту. Баланс цены и качества.
fal-ai/flux-pro/v1.111 ₽Флагман FLUX: максимальное качество, фотореализм, сложные сцены.
fal-ai/recraft-v311 ₽Топ для дизайна: логотипы, иконки, векторные стили, текст на картинке.

Озвучка текста

Эндпоинт 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-max2 ₽2000Родные русские голоса по самой низкой цене. Файл WAV.
elevenlabs/eleven-v4-turbo8 ₽5000Готово за пару секунд. Для роликов, ботов и черновиков.
elevenlabs/eleven-v416 ₽5000Самая живая интонация. Для аудиокниг, рекламы и подкастов.
silero/v5-ru0.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-sfx4 ₽ за запись1–60Эффекты. Шумы, фоны и атмосфера до минуты по одной цене.
elevenlabs/sound-effects-v30,4 ₽ за секунду1–30Эффекты. Точные короткие эффекты: удары, шаги, интерфейс, природа.
stability/stable-audio-3-music5 ₽ за запись5–120Музыка. Фоновая музыка без вокала до двух минут по одной цене.
elevenlabs/music-v2.52 ₽ за секунду5–120Музыка. Студийное звучание: заставки, джинглы, треки для роликов.

Список моделей

GET /v1/models возвращает полный каталог текстовых моделей в формате OpenAI. Цены на текстовые модели указаны в таблице тарифов и считаются за миллион токенов отдельно на вход и выход.

Коды ошибок

КодЧто означает
401Ключ не передан, неизвестен или отключён в кабинете.
402Закончился баланс либо ключ выбрал свой лимит трат. Пополните баланс или поднимите лимит ключа.
404Неизвестный идентификатор модели — сверьтесь со списком моделей.
502 / 504Провайдер недоступен или не ответил вовремя. Запрос можно повторить, списания за неудачную генерацию не происходит.

Частые вопросы

Какой базовый адрес у API?

https://store-api.ru/v1 — укажите его как base_url в любом OpenAI-совместимом SDK.

Нужен ли отдельный ключ для картинок?

Нет, работает тот же ключ и тот же баланс, что и для текстовых моделей.

Что означает ошибка 402?

Закончился баланс либо ключ выбрал назначенный ему лимит трат. Пополните баланс или поднимите лимит ключа в личном кабинете.