> ## Documentation Index
> Fetch the complete documentation index at: https://speshu.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Введение в API

> Базовый URL, аутентификация и форматы ответов SpeShu.AI API

SpeShu.AI — единый OpenAI-совместимый API для текстовых моделей и генерации изображений, видео, аудио и музыки.

## Базовый URL

```bash theme={null}
https://speshu.ai/api/v1
```

<Note>
  Все примеры в документации используют этот адрес. В официальных SDK достаточно поменять `base_url`.
</Note>

## Аутентификация

Большинству эндпоинтов нужен API-ключ. Передайте его одним из двух способов:

```bash theme={null}
Authorization: Bearer sk-ваш-ключ
```

```bash theme={null}
X-Api-Key: sk-ваш-ключ
```

Заголовок `X-Api-Key` нужен для совместимости с Anthropic SDK — он читает ключ именно оттуда. Остальные SDK используют `Authorization`.

<Note>
  Ключ создаётся в личном кабинете на [speshu.ai/profile](https://speshu.ai/profile) и показывается один раз. Подробности — на странице [Аутентификация](/docs/authentication).
</Note>

Два эндпоинта работают без ключа:

| Эндпоинт | Зачем без ключа |
| - | - |
| `GET /api/v1/models` | Посмотреть каталог моделей. С ключом вернутся цены вашего тарифа. |
| `GET /api/v1/media/models` | Посмотреть каталог медиа-моделей и схемы их параметров. |

## Три формата ответа

У API три разных формата тела ответа. Это не ошибка, а следствие того, что за разными группами эндпоинтов стоят разные протоколы совместимости.

| Группа эндпоинтов | Формат |
| - | - |
| Текст, баланс, авторизация | OpenAI |
| `/api/v1/messages` | Anthropic |
| Медиа и хранилище | Конверт `{"code", "msg", "data"}` |

<Warning>
  Клиент, который ожидает единый формат ошибок на всём базовом пути `/api/v1`, будет неправ на медиа-эндпоинтах. Все три формата разобраны на странице [Ошибки](/docs/errors).
</Warning>

## Таймауты и размеры запроса

| Что | Значение |
| - | - |
| Весь запрос к `/api/v1/*` | 300 секунд |
| Поток генерации текста | до 15 минут |
| Тело запроса к медиа-эндпоинтам | 100 МБ |
| Тело запроса к загрузке файла | 100 МБ |

## Что дальше

<CardGroup cols={2}>
  <Card title="Быстрый старт" icon="rocket" href="/docs/quickstart">
    Первый запрос за три шага
  </Card>

  <Card title="Аутентификация" icon="key" href="/docs/authentication">
    Как получить и использовать ключ
  </Card>

  <Card title="Ошибки" icon="triangle-exclamation" href="/docs/errors">
    Коды, форматы и что с ними делать
  </Card>

  <Card title="Модели и цены" icon="microchip" href="/docs/models">
    Каталог текстовых и медиа-моделей
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.