Привычные SDK, другой базовый адрес

from anthropic import Anthropic

client = Anthropic(
    base_url="https://ai-router-dev.dev.0sk.ru/anthropic",
    api_key="sk-samsa-...",
)
msg = client.messages.create(
    model="claude-opus-5",
    max_tokens=256,
    messages=[{"role": "user", "content": "привет"}],
)

from openai import OpenAI

client = OpenAI(
    base_url="https://ai-router-dev.dev.0sk.ru/openai/v1",
    api_key="sk-samsa-...",
)
resp = client.chat.completions.create(
    model="gpt-5.6-terra",
    messages=[{"role": "user", "content": "привет"}],
)

То же самое работает для любого языка: библиотеки этих двух вендоров принимают базовый адрес параметром. Полное описание зон, эндпоинтов и ограничений — на странице Router / API.

Что полезно знать до интеграции

Ключи под задачу, а не один на всё

Ключу задаются срок действия, месячный лимит и список разрешённых моделей. Для прода, стенда и экспериментов удобно держать разные ключи: расход виден по каждому отдельно.

Ошибки приходят как есть

Мы не переписываем ответы поставщика и не делаем автоматических повторов. Если поставщик вернул ошибку — денег не списываем, а решение о повторе остаётся за вами.

Каталог зависит от ключа

Запрос списка моделей возвращает то, что доступно конкретному ключу. Не зашивайте список в код — берите его из ответа.

Идентификатор запроса

Каждый ответ содержит X-Request-Id. Логируйте его: с ним разбор инцидента занимает минуты вместо переписки.