Программный доступ

Ключ создаётся в кабинете, в разделе «API». Он начинается с kadr- и показывается один раз.

curl https://ии-кадр.рф/api/v1/chat/completions \
  -H "Authorization: Bearer kadr-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "messages": [{"role": "user", "content": "Придумай название для магазина носков"}]
  }'

model: auto — модель выберем мы: это дёшево и не требует следить за нашим каталогом. Хотите конкретную — назовите её id из таблицы ниже.

Первое, что спрашивает почти любой клиент (Cline, LibreChat, выбор модели в редакторе). Отдаём стандартом OpenAI, а рядом со стандартными полями кладём свои цены — библиотеки лишнее поле игнорируют, а человеку не надо открывать кабинет, чтобы узнать тариф.

curl https://ии-кадр.рф/api/v1/models -H "Authorization: Bearer kadr-ВАШ_КЛЮЧ"
# {"object": "list", "data": [
#   {"id": "auto", "object": "model", "owned_by": "kadr",
#    "kadr": {"label": "Автовыбор", "vision": true}},
#   {"id": "doubao-seed-2-1-turbo-260628", "object": "model", "owned_by": "kadr",
#    "kadr": {"vision": true, "sell_kop_per_1m_in": 12000, "sell_kop_per_1m_out": 60000}}
# ]}

Поле vision — принимает ли модель картинки. Сообщение с картинкой уйдёт только в такую; если назвать модель без него, ответим отказом сразу, а не молчаливым ответом невпопад.

Формат тот же, что у OpenAI: части сообщения. Ссылку берём и обычную, и data:. Считается картинка не по длине строки, а по кадру — мегабайтный снимок не съест счёт.

curl https://ии-кадр.рф/api/v1/chat/completions \
  -H "Authorization: Bearer kadr-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "messages": [{"role": "user", "content": [
      {"type": "text", "text": "Что на снимке?"},
      {"type": "image_url", "image_url": {"url": "https://ваш-сайт/фото.jpg"}}
    ]}]
  }'

from openai import OpenAI

client = OpenAI(api_key="kadr-ВАШ_КЛЮЧ", base_url="https://ии-кадр.рф/api/v1")

answer = client.chat.completions.create(
    model="auto",
    messages=[{"role": "user", "content": "Привет"}],
)
print(answer.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({ apiKey: 'kadr-ВАШ_КЛЮЧ', baseURL: 'https://ии-кадр.рф/api/v1' });

const answer = await client.chat.completions.create({
  model: 'auto',
  messages: [{ role: 'user', content: 'Привет' }],
});
console.log(answer.choices[0].message.content);

Потоком — тот же вызов со stream: true: куски приходят стандартными chat.completion.chunk, последний несёт usage.

Любой клиент, который умеет «свой OpenAI-совместимый сервер», настраивается тремя полями. Отдельного режима для них у нас нет и не нужно.

Base URL (API Base / Endpoint):  https://ии-кадр.рф/api/v1
API key:                          kadr-ВАШ_КЛЮЧ
Model:                            auto  (или id из таблицы ниже)

Список моделей клиент возьмёт сам с GET /models. Если поле модели в клиенте обязательное и списка он не тянет — впишите auto: выбор сделаем мы.

По умолчанию размышления ВЫКЛЮЧЕНЫ — они утраивают ожидание и стоимость. Включаются полем reasoning_effort (формат OpenAI) или нашим thinking. Размышления приходят отдельным полем reasoning_content и оплачиваются как выходные токены: они входят в completion_tokens.

{"model": "deepseek-v4-flash-ga-260731",
 "reasoning_effort": "medium",        // none — выключить; любое другое значение — включить
 "thinking": "enabled",               // то же самое нашим полем: disabled | auto | enabled
 "messages": [{"role": "user", "content": "Посчитай по шагам: 17 × 23 + 5"}]}

Режим, которого у модели нет, — отказ 400, а не молчаливая подмена. И важное про деньги: с включёнными размышлениями потолок ответа считается по ВСЕМУ выходу, а не по видимому тексту; если остатка на счету хватает меньше чем на 512 токенов, придёт 402 — размышления съели бы потолок целиком, и ответа не осталось бы вовсе.

Пустой ответ модели — это штатный 200 с пустым content (как у OpenAI), и он тоже бесплатен. В потоке отказ приходит объектом error внутри потока — так его понимают клиентские библиотеки.

curl https://ии-кадр.рф/api/v1/images/generations \
  -H "Authorization: Bearer kadr-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"model": "doubao-seedream-4-5-251128", "prompt": "белая кружка на деревянном столе", "size": "2048x2048"}'

Ссылка на результат живёт около суток — скачивайте файл сразу, а не храните ссылку.

Пресет работает минуту и дольше, поэтому он устроен в два шага: создали задачу — опрашиваете её. Исходник передаётся ссылкой в input.image_url. У «Генерации по тексту» он НЕОБЯЗАТЕЛЕН: без него рисуем по описанию, с ним правим снимок — это разные работы и разные цены, обе в таблице ниже. input.size выбирает разрешение, а у роликов — длительность; цена у каждой строки своя.

# создать
curl https://ии-кадр.рф/api/v1/tasks \
  -H "Authorization: Bearer kadr-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"preset": "bg_replace", "input": {"image_url": "https://ваш-сайт/фото.jpg", "scene": "wood"}}'
# {"id": "…", "status": "queued", "poll": "/api/v1/tasks/…"}

# опросить
curl https://ии-кадр.рф/api/v1/tasks/ID -H "Authorization: Bearer kadr-ВАШ_КЛЮЧ"
# {"status": "succeeded", "result": [{"url": "…"}]}

Деньги списываются по факту ответа, с того же счёта, что и работа в кабинете. Стоимость вызова возвращается в поле kadr.cost_kop и видна в журнале вызовов.

Выше — модели, которые вызываются прямо сейчас. Ниже весь каталог, открытый нам у провайдера: помеченное «скоро» мы заводим в прайс по мере проверки.

• 60 запросов в минуту на ключ для чата, 20 — для изображений и задач.
• Потолок одного ответа — 16 384 токена, но не больше того, что можно оплатить остатком на счету. Свой предел задаётся полем max_tokens: мы его уважаем, в том числе маленький. Упёрлись в потолок — придёт честный finish_reason: "length", а применённое значение видно в kadr.max_tokens.
• Отозвали ключ — он перестаёт работать сразу, без отсрочки.
• Если через API вы передаёте персональные данные своих пользователей, нужен договор поручения — он принимается галочкой при создании ключа.
• Запросы уходят к провайдерам моделей за пределами России, в том числе в КНР. Это описано в политике конфиденциальности.