# Clef — решения, Cloudflare, через API СОЮЗа

> Идентификатор для поля `model`: `clef`. Страница: https://souz.ai/models/clef. Текст, изображение → Решение. Выпущена 1 октября 2026.

СОЮЗ — единый API к нейросетям разных вендоров: один ключ, общий баланс в рублях, списание только за успешный запрос. Эта модель вызывается по контракту ниже.

Clef — открытая модель с откалиброванными вероятностями. Сверяет фото с описанием и раскладывает запросы.

## Цены

Неуспешный запрос не тарифицируется. В ответах API итог — `price` у задачи и `usage.cost` у чата — целые микроединицы валюты платформы (1 единица = 1 000 000 микро), а сама валюта приезжает рядом полем `currency` (сейчас `RUB`). У незавершённой задачи `price: null`.

- Входные токены — от 38,018487 ₽ за 1M

Цены и типичное время пресетов роутинга — поле `routing`: `cheap` «Дешевле», `balanced` «Баланс» (по умолчанию), `fast` «Быстрее». Пресет задаёт порядок каналов; где пресеты начинают с одного канала, цена у них общая. Потолок `max_price_multiplier` (`1.5`, `2`, `3`, `5`, `10`) не даёт пробовать каналы дороже цены пресета больше чем во столько раз.

- Цена по каналам: Синий (`blue`) — 47,523108 ₽ за 1M входных токенов; Салатовый (`lime`) — 47,523108 ₽ за 1M входных токенов; Розовый (`pink`) — 38,018487 ₽ за 1M входных токенов.

Цена «от» — у самого дешёвого канала; цены и скорость каждого — в блоке «Каналы». При авто-роутинге цена может меняться.

## Каналы

Канал — постоянный цвет внутри модели: у каждого свои ставки, задержка, скорость и стабильность. Цвет не означает «дешёвый» или «быстрый», одинаковый цвет у другой модели — другой канал. Задержка и скорость — медиана за последний час, стабильность — доля успешных вызовов за 7 дней; «нет данных» — замеров пока мало, а не ноль.

Каналов: 3. Данные на момент сборки страницы; свежие — `GET https://api.souz.ai/v1/models/clef/channels` без ключа (там же HEX цвета, пределы входа и p90).

| Канал (`id`) | Название | Доступен | Ставки | Время ответа, p50 за сутки | Стабильность, 7 дней |
| --- | --- | --- | --- | --- | --- |
| `blue` | Синий | да | вход 47,523108 ₽ за 1M токенов | нет данных | нет данных |
| `lime` | Салатовый | да | вход 47,523108 ₽ за 1M токенов | нет данных | нет данных |
| `pink` | Розовый | да | вход 38,018487 ₽ за 1M токенов | 1,0 с | 100% |

Как выбрать канал:

- По умолчанию канал выбирает Авто-роутинг: пресет `routing` (`cheap`, `balanced`, `fast`) задаёт порядок каналов, при отказе запрос переходит к следующему.
- На один запрос — поле `routing_options`: `{"only": ["blue"]}` — только этот канал, без запасных; `{"order": ["blue"]}` — сначала он, затем остальные; `"allow_fallbacks": false` — только каналы из `order`; `{"ignore": [...]}` — исключить; `max_price` — пределы ставок. SDK OpenAI — через `extra_body`.
- Бесплатная проверка без запуска: `POST https://api.souz.ai/v1/models/clef/routing/preview` с теми же `routing`, `routing_options` и `params` — каналы в порядке попыток (`channels`), у каждого оценка `estimated_price`; запрос начнётся с первого. Пустой `channels` — с такими условиями запрос не выполнить. Настройки аккаунта превью применяет, как запрос.
- Закрепить по умолчанию для всех запросов аккаунта к модели: `PATCH https://api.souz.ai/v1/settings` ключом управления с `{"routing_options": {"clef": {"only": ["blue"]}}}`. PATCH заменяет всю карту — сначала прочитайте `GET https://api.souz.ai/v1/settings` и сохраните настройки других моделей. Запрос без `routing_options` наследует настройку; `{}` в запросе — автоматический выбор на один вызов.
- MCP: https://api.souz.ai/mcp — инструменты `list_channels`, `compare_channels`, `preview_routing`, `pin_channel`, `unpin_channel`. Подключение в Claude Code: `claude mcp add --transport http souz https://api.souz.ai/mcp --header "Authorization: Bearer $SOUZ_API_KEY"`.
- Каким каналом выполнен запрос — поле `channel` в ответе (у чата — и в каждом чанке потока), в задаче, вебхуке и истории запросов; `attempt_count` — сколько было попыток.

## Подключение по API

- Адрес: `POST https://api.souz.ai/v1/decisions`
- Авторизация: заголовок `Authorization: Bearer <ключ>`. Ключ создаётся в кабинете: https://souz.ai/keys.
- Тело запроса — JSON, `Content-Type: application/json`, поле `model` — `clef`.
- Ответ приходит сразу (без потока и без `202`): `answers` — ответы по именам вопросов из `questions`, `channel` — канал, `usage.input_tokens` и списание `usage.cost` в `usage.currency`. Оплачиваются только входные токены. Ответ по типу вопроса: `noul` — вероятность «да» от 0 до 1; `choice` — вариант, `confidence` и `probabilities`; `score` — позиция на шкале, `legend` и `probabilities`; `box` — рамка `top`, `bottom`, `left`, `right` в долях картинки. Задача — `GET https://api.souz.ai/v1/jobs/{id}`.
- Ошибки — JSON вида `{ "error": { "type", "code", "message", "detail" } }` с кодом HTTP 4xx/5xx; ветвиться — по `type` и `code`. `401` — неверный ключ; `402` с кодом `insufficient_balance` — не хватает средств на балансе, `key_spend_limit_exceeded` или `member_spend_limit_exceeded` — исчерпан лимит трат ключа или участника, повтор не поможет; `400` с кодом `capability_mismatch` или `invalid_request` — запрос не подходит модели, в `error.detail[]` — поле (`path`), причина (`reason`) и что подойдёт (`allowed`); `503 model_unavailable` — модель сейчас недоступна, повторите после `Retry-After`.
- Руководство по API целиком: https://souz.ai/docs, спецификация OpenAPI: https://api.souz.ai/openapi.json.

## Параметры запроса

Отправляются поля из этой таблицы. Кроме них — общие поля `routing`, `routing_options`, `max_price_multiplier` и `store`. Вся схема тела машинно — `input_schema` в карточке `GET /v1/models/clef` (JSON Schema): в ней `questions` и `assets` — объекты по ключу, `criteria` — по типу вопроса.

| Поле | Тип | Обязательное | Значения | По умолчанию | Описание |
| --- | --- | --- | --- | --- | --- |
| `state` | строка | да | текст | — | Контекст. Текст или JSON, о котором модель отвечает на вопросы. |
| `questions` | список | да | объекты с полями name, type, instructions, criteria, до 64 | — | Вопросы |
| `assets` | изображение | нет | изображения, до 4 | — | Картинки. PNG или JPEG base64. Укажите ключ картинки в контексте или в вопросе. |

## Ограничения

- Контекст: 65 536 токенов

## Примеры запроса

### cURL

```bash
curl https://api.souz.ai/v1/decisions \
  -H "Authorization: Bearer $SOUZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "clef",
    "state": {
      "ticket": "После нажатия «Оплатить» страница оформления заказа остаётся пустой.",
      "plan": "enterprise"
    },
    "questions": {
      "is_bug": {
        "type": "noul",
        "instructions": "Клиент сообщает об ошибке в работе сервиса?"
      },
      "team": {
        "type": "choice",
        "instructions": "Какая команда должна разобрать обращение?",
        "criteria": {
          "payments": "Оплата и счета.",
          "frontend": "Вёрстка и интерфейс.",
          "account": null
        }
      },
      "urgency": {
        "type": "score",
        "instructions": "Насколько это срочно?",
        "criteria": [
          "Следующий релиз",
          "На этой неделе",
          "Блокирует выручку"
        ]
      }
    }
  }'
```

### Python

```python
import os
import requests

SOUZ_API_KEY = os.environ["SOUZ_API_KEY"]

response = requests.post(
    "https://api.souz.ai/v1/decisions",
    headers={"Authorization": f"Bearer {SOUZ_API_KEY}"},
    json={
      "model": "clef",
      "state": {
        "ticket": "После нажатия «Оплатить» страница оформления заказа остаётся пустой.",
        "plan": "enterprise"
      },
      "questions": {
        "is_bug": {
          "type": "noul",
          "instructions": "Клиент сообщает об ошибке в работе сервиса?"
        },
        "team": {
          "type": "choice",
          "instructions": "Какая команда должна разобрать обращение?",
          "criteria": {
            "payments": "Оплата и счета.",
            "frontend": "Вёрстка и интерфейс.",
            "account": null
          }
        },
        "urgency": {
          "type": "score",
          "instructions": "Насколько это срочно?",
          "criteria": [
            "Следующий релиз",
            "На этой неделе",
            "Блокирует выручку"
          ]
        }
      }
    },
)
print(response.json())
```

### TypeScript

```typescript
const response = await fetch("https://api.souz.ai/v1/decisions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOUZ_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "clef",
    "state": {
      "ticket": "После нажатия «Оплатить» страница оформления заказа остаётся пустой.",
      "plan": "enterprise"
    },
    "questions": {
      "is_bug": {
        "type": "noul",
        "instructions": "Клиент сообщает об ошибке в работе сервиса?"
      },
      "team": {
        "type": "choice",
        "instructions": "Какая команда должна разобрать обращение?",
        "criteria": {
          "payments": "Оплата и счета.",
          "frontend": "Вёрстка и интерфейс.",
          "account": null
        }
      },
      "urgency": {
        "type": "score",
        "instructions": "Насколько это срочно?",
        "criteria": [
          "Следующий релиз",
          "На этой неделе",
          "Блокирует выручку"
        ]
      }
    }
  }),
});
console.log(await response.json());
```

### Канал

```bash
curl https://api.souz.ai/v1/decisions \
  -H "Authorization: Bearer $SOUZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "clef",
    "state": {
      "ticket": "После нажатия «Оплатить» страница оформления заказа остаётся пустой.",
      "plan": "enterprise"
    },
    "questions": {
      "is_bug": {
        "type": "noul",
        "instructions": "Клиент сообщает об ошибке в работе сервиса?"
      },
      "team": {
        "type": "choice",
        "instructions": "Какая команда должна разобрать обращение?",
        "criteria": {
          "payments": "Оплата и счета.",
          "frontend": "Вёрстка и интерфейс.",
          "account": null
        }
      },
      "urgency": {
        "type": "score",
        "instructions": "Насколько это срочно?",
        "criteria": [
          "Следующий релиз",
          "На этой неделе",
          "Блокирует выручку"
        ]
      }
    },
    "routing_options": {
      "only": [
        "blue"
      ]
    }
  }'
```

## Примеры ответа

### Ответ

```json
{
  "id": "job_1a2b3c4d5e6f",
  "model": "clef",
  "channel": "blue",
  "answers": {
    "is_bug": {
      "type": "noul",
      "noul": 0.96
    },
    "team": {
      "type": "choice",
      "choice": "payments",
      "confidence": 0.75,
      "probabilities": {
        "payments": 0.84,
        "frontend": 0.16,
        "account": 0
      }
    },
    "urgency": {
      "type": "score",
      "score": 1.99,
      "confidence": 0.99,
      "legend": {
        "0": "Следующий релиз",
        "1": "На этой неделе",
        "2": "Блокирует выручку"
      },
      "probabilities": {
        "0": 0,
        "1": 0.01,
        "2": 0.99
      }
    }
  },
  "usage": {
    "input_tokens": 476,
    "output_tokens": 0,
    "cost": 18097,
    "currency": "RUB"
  }
}
```

## Статистика за 7 дней

По запросам всех клиентов: запросов — 47, успешных — 100%, медиана времени ответа — 1,0 с, 95% запросов быстрее 1,8 с.

Время ответа — по успешным запросам; медиана и p95 округлены (±10 %), поэтому у разных моделей числа могут совпадать. По часам и без ключа: `GET https://api.souz.ai/v1/models/clef/stats`.

## Вопросы и ответы

**Что такое Clef?**

Clef — открытая модель с откалиброванными вероятностями. Сверяет фото с описанием и раскладывает запросы. Доступна в СОЮЗе по единому API и в плейграунде на этой странице.

**Сколько стоит Clef?**

Clef стоит от 38,018487 ₽ за 1M. Цена «от» — у самого дешёвого канала; цены и скорость каждого — в блоке «Каналы». При авто-роутинге цена может меняться. Списывается только успешный запрос по фактическому числу входных токенов, ответ не оплачивается, неудачный не стоит ничего.

**Что Clef принимает на вход и что отдаёт?**

Clef принимает текст и изображения и отдаёт ответы на вопросы: да или нет, выбор варианта, оценку по шкале. В одном запросе: картинки — до 4 изображений.

**Какой размер контекста у Clef?**

У Clef контекст — 65 536 токенов.

**Как вызвать Clef через API?**

Запросом POST https://api.souz.ai/v1/decisions с полем model: "clef" и ключом СОЮЗа в заголовке Authorization: Bearer. В теле — состояние state и вопросы questions, картинки — в assets. Ответ приходит сразу: answers по именам вопросов и списание в usage.cost. Примеры на cURL, Python и TypeScript — в разделе «Подключение по API».

**Что такое каналы Clef и как выбрать конкретный?**

Clef выполняется через 3 канала: «Синий» (blue), «Салатовый» (lime) и «Розовый» (pink). У каждого канала свои ставки, задержка, скорость и стабильность за 7 дней — они в блоке «Каналы» на этой странице и в GET https://api.souz.ai/v1/models/clef/channels. Цвет не означает «дешёвый» или «быстрый», а одинаковый цвет у другой модели — другой канал. По умолчанию канал выбирает Авто-роутинг по пресету «Дешевле», «Баланс» или «Быстрее». Конкретный канал задаёт поле routing_options: {"only": ["blue"]} — только этот канал, {"order": ["blue"]} — сначала он, затем остальные. Чтобы закрепить канал для всех запросов к модели, сохраните ту же настройку в аккаунте: PATCH https://api.souz.ai/v1/settings ключом управления или в кабинете. Каким каналом выполнен запрос, видно в поле channel ответа и в истории.

**Как быстро и стабильно работает Clef?**

За последние 7 дней медиана времени ответа Clef — 1,0 с, 95% запросов укладываются в 1,8 с, доля успешных — 100% при 47 запросах. Считается по запросам всех клиентов СОЮЗа.

**Можно ли попробовать Clef без кода?**

Да: плейграунд на этой странице запускает Clef с теми же параметрами, что и API. Нужен аккаунт СОЮЗа. Итоговая стоимость считается по фактическому числу входных токенов. Пока запрос выполняется, в истории вместо цены стоит прочерк; итог появляется только после завершения.

**Когда вышла Clef?**

Clef выпущена Cloudflare 1 октября 2026.

## Ссылки

- Страница модели: https://souz.ai/models/clef
- Каталог моделей: https://souz.ai/models
- Все модели одним файлом: https://souz.ai/llms.txt
- Кабинет (ключи, баланс, история запросов): https://souz.ai/overview
