{
  "info": {
    "name": "ИИ-адаптер API",
    "_postman_id": "aiadapter-api-v1",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "description": "Единый API ко всем ИИ-моделям (OpenRouter/OpenAI-совместимо). Задайте переменную коллекции api_key."
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{api_key}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "api_key",
      "value": "sk-aa-v1-..."
    }
  ],
  "item": [
    {
      "name": "Текстовые модели",
      "item": [
        {
          "name": "POST /chat/completions (chat-completions)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "https://api.aiadapter.ru/api/v1/chat/completions",
              "protocol": "https",
              "host": [
                "api",
                "aiadapter",
                "ru"
              ],
              "path": [
                "api",
                "v1",
                "chat",
                "completions"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"model\": \"anthropic/claude-opus-4.8\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Привет!\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Генерация ответа в формате чата. Полностью совместимо с OpenAI Chat Completions. Поддерживает стриминг (SSE), вызов инструментов, vision и генерацию картинок."
          }
        },
        {
          "name": "POST /completions",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "https://api.aiadapter.ru/api/v1/completions",
              "protocol": "https",
              "host": [
                "api",
                "aiadapter",
                "ru"
              ],
              "path": [
                "api",
                "v1",
                "completions"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"model\": \"anthropic/claude-opus-4.8\",\n  \"prompt\": \"Жили-были\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Классическое текстовое дополнение (legacy). Принимает строку prompt вместо массива сообщений."
          }
        },
        {
          "name": "POST /embeddings",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "https://api.aiadapter.ru/api/v1/embeddings",
              "protocol": "https",
              "host": [
                "api",
                "aiadapter",
                "ru"
              ],
              "path": [
                "api",
                "v1",
                "embeddings"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"model\": \"openai/text-embedding-3-small\",\n  \"input\": \"Привет, мир\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Векторные представления (эмбеддинги) текста — для поиска, кластеризации, RAG."
          }
        },
        {
          "name": "POST /messages",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "https://api.aiadapter.ru/api/v1/messages",
              "protocol": "https",
              "host": [
                "api",
                "aiadapter",
                "ru"
              ],
              "path": [
                "api",
                "v1",
                "messages"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"model\": \"anthropic/claude-opus-4.8\",\n  \"max_tokens\": 1024,\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Привет!\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Эндпоинт в формате Anthropic Messages. Удобно, если у вас уже есть код под Anthropic SDK — поменяйте base URL и ключ."
          }
        },
        {
          "name": "POST /responses",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "https://api.aiadapter.ru/api/v1/responses",
              "protocol": "https",
              "host": [
                "api",
                "aiadapter",
                "ru"
              ],
              "path": [
                "api",
                "v1",
                "responses"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"model\": \"anthropic/claude-opus-4.8\",\n  \"input\": \"Привет!\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Эндпоинт в формате OpenAI Responses API — современная альтернатива chat/completions с полем input и встроенными инструментами."
          }
        }
      ]
    },
    {
      "name": "Аудио/Видео",
      "item": [
        {
          "name": "POST /videos (video)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "https://api.aiadapter.ru/api/v1/videos",
              "protocol": "https",
              "host": [
                "api",
                "aiadapter",
                "ru"
              ],
              "path": [
                "api",
                "v1",
                "videos"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"model\": \"minimax/video-01\",\n  \"prompt\": \"Кот играет на пианино\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Текст → видео. Асинхронно: POST создаёт задачу и возвращает её id, статус опрашивается через GET /videos/{id}, готовый файл — через GET /videos/{id}/content."
          }
        },
        {
          "name": "POST /chat/completions (image-generation)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "https://api.aiadapter.ru/api/v1/chat/completions",
              "protocol": "https",
              "host": [
                "api",
                "aiadapter",
                "ru"
              ],
              "path": [
                "api",
                "v1",
                "chat",
                "completions"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"model\": \"google/gemini-3.5-flash-image\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Нарисуй кота-космонавта\"\n    }\n  ],\n  \"modalities\": [\n    \"image\",\n    \"text\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Текст → картинка. Тоже через /chat/completions: укажите модель с output-модальностью «Изображения» и попросите сгенерировать изображение. Картинка возвращается в ответе."
          }
        },
        {
          "name": "POST /chat/completions (vision)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "https://api.aiadapter.ru/api/v1/chat/completions",
              "protocol": "https",
              "host": [
                "api",
                "aiadapter",
                "ru"
              ],
              "path": [
                "api",
                "v1",
                "chat",
                "completions"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"model\": \"google/gemini-3.5-flash\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": [\n        {\n          \"type\": \"text\",\n          \"text\": \"Что изображено на картинке?\"\n        },\n        {\n          \"type\": \"image_url\",\n          \"image_url\": {\n            \"url\": \"https://example.com/cat.jpg\"\n          }\n        }\n      ]\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Картинка → текст (vision). Это НЕ отдельный метод: передайте изображение в content сообщения как элемент image_url у обычного /chat/completions."
          }
        },
        {
          "name": "POST /audio/transcriptions (stt)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "https://api.aiadapter.ru/api/v1/audio/transcriptions",
              "protocol": "https",
              "host": [
                "api",
                "aiadapter",
                "ru"
              ],
              "path": [
                "api",
                "v1",
                "audio",
                "transcriptions"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"model\": \"openai/gpt-4o-transcribe\",\n  \"file\": \"<base64-аудио>\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Речь → текст (STT). Принимает аудио (base64), возвращает расшифровку."
          }
        },
        {
          "name": "POST /audio/speech (tts)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "https://api.aiadapter.ru/api/v1/audio/speech",
              "protocol": "https",
              "host": [
                "api",
                "aiadapter",
                "ru"
              ],
              "path": [
                "api",
                "v1",
                "audio",
                "speech"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"model\": \"openai/gpt-4o-mini-tts\",\n  \"input\": \"Привет!\",\n  \"voice\": \"alloy\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Текст → речь (TTS). Возвращает бинарный аудиопоток (audio/mpeg и т.п.). Тарифицируется по факту генерации."
          }
        }
      ]
    },
    {
      "name": "Каталог",
      "item": [
        {
          "name": "GET /models",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "https://api.aiadapter.ru/api/v1/models",
              "protocol": "https",
              "host": [
                "api",
                "aiadapter",
                "ru"
              ],
              "path": [
                "api",
                "v1",
                "models"
              ]
            },
            "description": "Список доступных моделей с ценами и характеристиками."
          }
        },
        {
          "name": "GET /providers",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "https://api.aiadapter.ru/api/v1/providers",
              "protocol": "https",
              "host": [
                "api",
                "aiadapter",
                "ru"
              ],
              "path": [
                "api",
                "v1",
                "providers"
              ]
            },
            "description": "Список провайдеров, доступных через шлюз."
          }
        }
      ]
    },
    {
      "name": "Аккаунт",
      "item": [
        {
          "name": "GET /key",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "https://api.aiadapter.ru/api/v1/key",
              "protocol": "https",
              "host": [
                "api",
                "aiadapter",
                "ru"
              ],
              "path": [
                "api",
                "v1",
                "key"
              ]
            },
            "description": "Информация о текущем ключе: лимит, израсходовано и остаток (в рублях)."
          }
        },
        {
          "name": "GET /credits",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "https://api.aiadapter.ru/api/v1/credits",
              "protocol": "https",
              "host": [
                "api",
                "aiadapter",
                "ru"
              ],
              "path": [
                "api",
                "v1",
                "credits"
              ]
            },
            "description": "Баланс аккаунта: всего пополнено и всего израсходовано (в рублях)."
          }
        },
        {
          "name": "GET /generation",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "https://api.aiadapter.ru/api/v1/generation?id=",
              "protocol": "https",
              "host": [
                "api",
                "aiadapter",
                "ru"
              ],
              "path": [
                "api",
                "v1",
                "generation"
              ],
              "query": [
                {
                  "key": "id",
                  "value": ""
                }
              ]
            },
            "description": "Метаданные и стоимость одной генерации по её id (id берётся из поля id в ответе на запрос). Доступны только ваши генерации."
          }
        }
      ]
    }
  ]
}