OpenAI-compatible

Документация API

Быстрый старт для /openapi/v1: получить список моделей, вызвать генерацию изображений и отправить chat completion.

Ключи API Каталог моделей
Bearer auth curl / fetch / SDK Изображения + чат
Base URL

Подставьте этот адрес в клиент или скрипт. Все примеры ниже используют его напрямую.

Авторизация Bearer

Создайте персональный ключ в настройках и передавайте его в заголовке Authorization: Bearer YOUR_API_KEY.

Quick Start

С чего начать

В AI Retry поле model всегда должно содержать slug модели из вашего каталога, а не маркетинговое название.

01

Создайте ключ

Откройте настройки аккаунта, создайте Bearer-ключ и сохраните его сразу после выдачи.

02

Проверьте доступные slug

Запросите GET /openapi/v1/models и используйте точный id модели в поле model.

03

Отправьте вызов

Для текста используйте /chat/completions, для изображений /images/generations.

Endpoints

Что поддерживает API

Это те же эндпоинты, которые уже работают в сервере. Никакой отдельной версии документации здесь нет.

GET /openapi/v1/models

Список доступных моделей и их slug для поля model.

POST /openapi/v1/images/generations

Генерация изображений в OpenAI-совместимом формате. Передавайте prompt и параметры выбранной модели в теле запроса.

POST /openapi/v1/chat/completions

Текстовые и чат-модели. Сервис сам приводит messages к входной схеме выбранной модели.

Discovery

Как узнать точный slug модели

Запросите список моделей перед первой интеграцией. Slug в каталоге может отличаться от маркетингового названия модели.

curl

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


          

          

            

              JSON
              
Фрагмент ответа

            

            

          

        

      


      

        

          

            
Image

            
Пример: Nano Banana

          

          
Пример ниже использует nano-banana через /images/generations. Если у вас включён другой slug, замените только значение поля model.

        

        

          Что поддерживается в этом примере:
          prompt, aspect ratio, output format и синхронный ответ с итоговым URL изображения.
        

        

          

            

              

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

              

              
            

            

          

          

            

              

                JavaScript
                
Node / fetch

              

              
            

            

          

        

        

          

            JSON
            
Фрагмент ответа

          

          

        

      


      

        

          

            
Chat

            
Пример: GPT 5.4 style

          

          
В примере используется gpt-5.4 как ожидаемый slug. Если в вашем каталоге модель включена под другим id, сначала проверьте /openapi/v1/models и замените поле model.

        

        

          Как это работает:
          вы отправляете стандартный массив messages, а AI Retry сам собирает payload под схему выбранной текстовой модели.
        

        

          

            

              

                curl
                
Chat completion

              

              
            

            

          

          

            

              

                JavaScript
                
OpenAI SDK

              

              
            

            

          

        

        

          

            JSON
            
Фрагмент ответа

          

          

        

      


      

        

          

            
Notes

            
Практические замечания

          

          
Коротко о том, что важно при интеграции, чтобы не тратить время на первую отладку.

        

        

          

            n в images
            
Сервис поддерживает только n=1. Если передать другое значение, API вернёт ошибку валидации.

          

          

            response_format
            
Для изображений доступны url по умолчанию и b64_json, если нужен base64 вместо ссылки на файл.

          

          

            max_tokens и temperature
            
Для chat completion они подставляются только если соответствующие поля есть в схеме выбранной модели.

          

          

            Ошибки
            
При нехватке баланса сервер возвращает 402, при неизвестной модели 404, при таймауте генерации 504.