aisplice

Справочник API

Старые API и совместимость

#Совместимость с OpenAI

Каждый путь принимает тело запроса в формате OpenAI — специфичные для провайдеров параметры (anthropic tool_use, gemini thinking_config) передаются без изменений.

Тот же формат ответа, что у OpenAI

Тело ответа полностью совпадает с OpenAI, поэтому парсеры, логика повторов и обёртки для мониторинга, написанные под OpenAI, продолжают работать.

Эндпоинты на этой странице работают и тарифицируются как любые другие, но это не рекомендуемый способ интеграции. Используйте их, если существующий SDK провайдера должен работать без изменений или вам достался вызов, который вы пока не готовы переносить.

#Какой набор API выбрать?

Новая интеграция

Используйте эндпоинты /v1 в формате OpenAI из справочника API. Единые термины для всех возможностей, и только здесь появляются новые параметры.

Уже есть SDK провайдера

Используйте подходящий сквозной маршрут ниже. Вы меняете базовый URL и ключ, а тело запроса провайдера остаётся прежним.

Унаследованный старый вызов

Он продолжит работать. Перенесите его, когда в следующий раз будете менять этот код, — эти маршруты заморожены и не развиваются.

#Нативные форматы провайдеров (сквозная передача)

Эти маршруты принимают тело запроса в формате провайдера и возвращают ответ в его же формате. Аутентификация — по-прежнему один заголовок Authorization: Bearer с ключом этой платформы; схема аутентификации провайдера не используется.

Нативный Gemini

сквозная передача

Направьте Google GenAI SDK на этот шлюз без изменений в коде. Формат пути generateContent и тело запроса — как у самого Gemini.

GET/v1beta/modelsСписок моделей в формате каталога Gemini.
POST/v1beta/models/*Формат пути Gemini: /v1beta/models/{model}:{action}, например :generateContent или :streamGenerateContent.
POST/v1/models/*Тот же формат запросов Gemini под /v1 — для клиентов, которые не могут сменить префикс версии API.
POST/v1/engines/:model/embeddingsЭмбеддинги Gemini через устаревший путь engines.

Нативный Kling

сквозная передача

Принимает официальное тело запроса Kling (model_name + prompt и собственные поля провайдера) и возвращает задачу в его формате.

POST/kling/v1/videos/text2videoОтправить задачу Kling «видео по тексту» в собственном формате провайдера.
POST/kling/v1/videos/image2videoОтправить задачу Kling «видео по изображению».
GET/kling/v1/videos/text2video/:task_idОпрос задачи Kling «видео по тексту».
GET/kling/v1/videos/image2video/:task_idОпрос задачи Kling «видео по изображению».

Нативный Jimeng

сквозная передача

Официальный API Jimeng на основе параметра Action. Отправка и получение результата используют один путь и различаются значением Action.

POST/jimeng/?Action=CVSync2AsyncSubmitTask&Version=2022-08-31Отправить задачу с req_key и prompt в теле в формате провайдера. Завершающий слеш обязателен: /jimeng перенаправляет, а при 301 большинство HTTP-клиентов теряют тело запроса.
POST/jimeng/?Action=CVSync2AsyncGetResult&Version=2022-08-31Получить результат отправленной задачи.

Нативный Suno

сквозная передача

Отправка и получение музыки в формате Suno. Для новых интеграций лучше использовать /v1/music/generations — он возвращает задачу в едином формате платформы.

POST/suno/submit/:actionaction — music или lyrics.
POST/suno/fetchПакетное получение по списку ID.
GET/suno/fetch/:idПолучить одну задачу.
gemini-native.sh
# Google GenAI SDK: set the API endpoint, keep everything else.
curl "https://www.aisplice.store/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Say hello."}]}]
  }'

Ответы сквозных маршрутов формирует провайдер, а не мы

Коды статуса, тела ошибок и названия полей на этих маршрутах соответствуют вышестоящему провайдеру. Формат ошибок платформы и описанные коды ошибок относятся только к отказам на стороне шлюза: аутентификация, квота, маршрутизация.

#Замороженные устаревшие маршруты

Маршрутизируются и тарифицируются, но закрыты для изменений: новых параметров не будет, новые модели не гарантируются, совместимость обещана только в рамках того, что работает сейчас.

Устаревшие псевдонимы

заморожен

По-прежнему маршрутизируются и тарифицируются, но заморожены: новых параметров не будет, совместимость не гарантируется. Переходите на актуальные пути, когда будете менять вызывающий код.

POST/v1/completionsУстаревший prompt completion от OpenAI. Используйте /v1/chat/completions.
POST/v1/editsНесмотря на название, ведёт к формату редактирования изображений. Используйте /v1/images/edits.
POST/v1/video/generationsОтправка видео в старом формате (до OpenAI-совместимого). Используйте POST /v1/videos.
GET/v1/video/generations/:task_idОпрос видео в старом формате (до OpenAI-совместимого). Используйте GET /v1/videos/{task_id}.

Архив Midjourney

заморожен

Только чтение. Платная отправка задач в Midjourney прекращена; доступен только просмотр прошлых задач и их архивных изображений.

GET/mj/task/:id/fetchПросмотреть архивную задачу.
GET/mj/task/:id/image-seedПолучить seed архивного изображения.
GET/mj/image/:idОтдать архивное изображение.

#Когда возвращается 404

Неподдерживаемые части OpenAI API вообще не зарегистрированы. 404 на пути OpenAI означает, что эта возможность здесь действительно не поддерживается, — это не временный пробел, и нет маршрутов, которые отвечали бы 501, делая вид, что это не так.

Как узнать, что реально доступно ключу

GET /v1/models возвращает все модели, которые может вызывать этот ключ. Сопоставив это с ответом 404 на сам путь, можно отличить «модель не разрешена» от «эндпоинт не поддерживается».

Проблема не решена?

Пришлите нам ID запроса или текст ошибки, и мы разберёмся.

НазадОплата и балансДалееПеред запуском