Работа с FableAI API

Один API-ключ для Claude Code, Cline, 9Router, Cursor, Anthropic SDK и OpenAI SDK. Скопируйте Base URL ниже, вставьте свой ключ и выберите модель.

Base URL · формат Anthropic
Base URL · формат OpenAI
API-ключ
sk-ant-fai-…Создать
01 /

Начните за 6 шагов

От регистрации до первого запроса примерно за две минуты.

  1. 1
    Шаг 1 / 6

    Создайте аккаунт

    Откройте страницу регистрации, введите имя, email и пароль, отметьте согласие с условиями и нажмите Create account.

    Форма регистрации
  2. 2
    Шаг 2 / 6

    Подтвердите email

    Мы отправим на ваш email 6-значный код. Введите его в поля и нажмите Verify email. Если письмо не пришло в течение минуты, проверьте папку «Спам».

    Шестизначный код из письма
  3. 3
    Шаг 3 / 6

    Активируйте купон

    Откройте страницу Баланс, вставьте код купона и нажмите Add to balance. Средства зачисляются сразу. Вы можете в любое время активировать новые купоны в том же аккаунте: все они суммируются в одном балансе.

    Страница баланса с кодом купона
  4. 4
    Шаг 4 / 6

    Создайте API-ключ

    Откройте API Keys и нажмите Create key. Дайте ключу имя. Spend limit (лимит расходов) необязателен: оставьте поле пустым, чтобы не ограничивать расходы, или задайте лимит, и ключ приостановится при его достижении. Expires (срок действия) тоже необязателен. Speed (скорость): 60 запросов в минуту включены; более высокая скорость немного дороже за токен.

    Окно создания API-ключа
  5. 5
    Шаг 5 / 6

    Скопируйте и сохраните ключ

    Ключ показывается только один раз. Нажмите Copy, сохраните его в надёжном месте, затем нажмите I've saved it. В целях безопасности мы храним только отпечаток ключа, поэтому показать его повторно невозможно. Потеряли ключ? Удалите его и создайте новый.

    Новый ключ показывается один раз
  6. 6
    Шаг 6 / 6

    Подключите инструмент

    Вставьте Base URL и ключ в Claude Code, Cline, 9Router, Cursor или любой SDK. Посмотрите, какой Base URL использовать, а затем настройку для Claude Code и других инструментов.

Попробуйте отправить первый запрос:

# ~/.zshrc
export ANTHROPIC_BASE_URL="https://api.fableaiapi.com"
export ANTHROPIC_AUTH_TOKEN="sk-ant-fai-your-key"

claude   # that's it
02 /

Какой Base URL использовать?

Сервер один, но обращаться к нему можно двумя способами. Каждый инструмент использует один из них. Разница только в том, добавляется ли /v1 в конце.

Формат Anthropic
Вставьте как Base URL
Дальше инструмент сам обращается к https://api.fableaiapi.com/v1/messages.
Claude Code, Anthropic SDK, Cline и Roo Code (провайдер Anthropic), 9Router (Anthropic Compatible)
Формат OpenAI
Вставьте как Base URL
Дальше инструмент сам обращается к https://api.fableaiapi.com/v1/chat/completions.
Cursor, OpenAI SDK, Cline и Roo Code (OpenAI Compatible), 9Router (OpenAI Compatible)
Простое правило: если инструмент просит URL Anthropic, указывайте его без /v1. Если просит URL OpenAI, добавьте /v1. Никогда не вставляйте /messages или /chat/completions в поле Base URL: инструмент добавит это сам.

Все инструменты в одной таблице

Claude CodeANTHROPIC_BASE_URLANTHROPIChttps://api.fableaiapi.com
Anthropic SDK (Python, Node)base_url / baseURLANTHROPIChttps://api.fableaiapi.com
Cline, Roo CodeПровайдер: Anthropic, свой Base URLANTHROPIChttps://api.fableaiapi.com
9RouterAdd Anthropic CompatibleANTHROPIChttps://api.fableaiapi.com
Cline, Roo CodeПровайдер: OpenAI CompatibleOPENAIhttps://api.fableaiapi.com/v1
9RouterAdd OpenAI CompatibleOPENAIhttps://api.fableaiapi.com/v1
CursorOverride OpenAI Base URLOPENAIhttps://api.fableaiapi.com/v1
OpenAI SDK, LiteLLM, LangChainbase_url (OpenAI)OPENAIhttps://api.fableaiapi.com/v1

Обращаетесь к API напрямую через curl или fetch? Используйте полный адрес: https://api.fableaiapi.com/v1/messages или https://api.fableaiapi.com/v1/chat/completions.

Некоторые ошибки исправляются автоматически: двойной /v1/v1 и отсутствующий /v1 перед /chat/completions тоже работают. Не ставьте слеш в конце Base URL.

03 /

Claude Code

Укажите Base URL и ключ в файле настроек Claude Code, затем запустите claude. Работает в macOS, Windows и Linux, а также в расширениях для VS Code и JetBrains.

~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.fableaiapi.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-ant-fai-your-key"
  }
}

В Windows этот файл находится по пути C:\Users\ВАШЕ-ИМЯ\.claude\settings.json. Эти же два значения можно задать только для текущей сессии терминала:

macOS / Linux
export ANTHROPIC_BASE_URL="https://api.fableaiapi.com"
export ANTHROPIC_AUTH_TOKEN="sk-ant-fai-your-key"
claude
Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://api.fableaiapi.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-ant-fai-your-key"
claude
Выберите модель в Claude Code командой /model или запустите claude --model claude-sonnet-5-5. Выполните /status и убедитесь, что Base URL равен https://api.fableaiapi.com.
04 /

Cline, 9Router, Cursor

Используйте один и тот же ключ во всех инструментах. Если инструмент предлагает вариант Anthropic, выбирайте его.

Cline / Roo Code (VS Code)

Вариант A · Anthropic (рекомендуется)
API Provider
Anthropic
Свой Base URL
https://api.fableaiapi.com
API-ключ
sk-ant-fai-…
Модель
claude-sonnet-5-5
Вариант B · OpenAI Compatible
API Provider
OpenAI Compatible
Base URL
https://api.fableaiapi.com/v1
API-ключ
sk-ant-fai-…
ID модели
claude-sonnet-5-5

9Router

  1. Откройте Providers и выберите Add Anthropic Compatible с Base URL https://api.fableaiapi.com или Add OpenAI Compatible с https://api.fableaiapi.com/v1.
  2. Нажмите Add API Key, вставьте ключ, дождитесь статуса Valid и сохраните.
  3. Нажмите Import Models: появятся все модели, доступные вашему ключу.

Cursor

  1. Откройте Settings → Models → API Keys.
  2. Вставьте ключ в OpenAI API Key и включите Override OpenAI Base URL со значением https://api.fableaiapi.com/v1.
  3. Добавьте свою модель с ID из списка и выберите её в чате.

OpenAI SDK

Python · openai
from openai import OpenAI

client = OpenAI(base_url="https://api.fableaiapi.com/v1", api_key="sk-ant-fai-your-key")
r = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[{"role": "user", "content": "Hello, Claude"}],
)
print(r.choices[0].message.content)

Поддерживаются стриминг, вызов инструментов и функций, изображения и stream_options.include_usage. Тарификация такая же, как в формате Anthropic.

05 /

Справочник API

POST/v1/messagesСоздать сообщение, со стримингом или без
POST/v1/chat/completionsЧат в формате OpenAI: стриминг, инструменты, изображения
POST/v1/messages/count_tokensПодсчитать токены запроса (бесплатно)
GET/v1/modelsСписок моделей (оба формата)

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

Передавайте ключ в любом из двух заголовков. Оба работают на всех эндпоинтах, поэтому подойдёт тот, что отправляет ваш инструмент.

Стиль Anthropic
Стиль OpenAI

Другие заголовки не нужны. Если SDK отправляет anthropic-version или anthropic-beta, они передаются без изменений.

Запрос
curl https://api.fableaiapi.com/v1/messages \
  -H "x-api-key: $FABLEAI_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'
Ответ
{
  "id": "msg_01...",
  "type": "message",
  "role": "assistant",
  "content": [{ "type": "text", "text": "Hello! How can I help?" }],
  "model": "claude-sonnet-5-5",
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 12, "output_tokens": 9 }
}
06 /

Модели

Одна цена за миллион токенов для каждой модели. Указывайте ID точно так, как показано.

Fable 5.2NEW$13.33 /1M
1M контекст
Fable 5.1$13.33 /1M
1M контекст
Opus 5.5$12.50 /1M
1M контекст
Sonnet 5.5$12.90 /1M
1M контекст
Haiku 5.5$13.33 /1M
200K контекст
Fable 5$12.12 /1M
1M контекст
Opus 5$11.43 /1M
1M контекст
Sonnet 5$11.76 /1M
1M контекст
Opus 4.8$11.11 /1M
1M контекст
Opus 4.7$11.11 /1M
1M контекст
Opus 4.6$11.11 /1M
1M контекст
Sonnet 4.6$11.11 /1M
1M контекст
Opus 4.5$11.11 /1M
200K контекст
Sonnet 4.5$11.11 /1M
200K контекст
Haiku 4.5$11.11 /1M
200K контекст
Opus 4.1$11.11 /1M
200K контекст

Тот же список возвращает GET /v1/models, поэтому инструменты вроде 9Router могут импортировать его.

07 /

Стриминг

Отправьте "stream": true. События передаются сразу по мере поступления. Оплата списывается по завершении потока, даже если вы отключились раньше.

Python · anthropic
import anthropic

client = anthropic.Anthropic(base_url="https://api.fableaiapi.com", api_key="sk-ant-fai-your-key")
with client.messages.stream(
    model="claude-sonnet-5-5", max_tokens=1024,
    messages=[{"role": "user", "content": "Write a haiku about APIs"}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)
08 /

Лимиты запросов

60
запросов / мин

На ключ, включено.

180
запросов / мин

Максимум на ключ. Более быстрый ключ дороже на 5-20%.

300
запросов / мин

Все ключи одного аккаунта вместе.

Скорость ключа задаётся при создании или редактировании на странице API Keys. При превышении лимита возвращается 429 rate_limit_error с заголовком retry-after. Официальные SDK и Claude Code сами ждут и повторяют запрос.

Если при небольшом балансе одновременно выполняется много запросов, новые получают 429 с retry-after: 5, пока один из текущих не завершится. Так баланс не уходит в минус. Ничего не теряется: при повторе запрос проходит.
09 /

Ошибки

Ошибки имеют тот же JSON-формат, что и в Anthropic API: {"type":"error","error":{"type":"…","message":"…"}}

400invalid_request_errorТело запроса не является корректным JSON или отсутствует поле.
401authentication_errorAPI-ключ отсутствует или неверен.
402billing_errorБаланс исчерпан. Активируйте купон на странице «Баланс».
403permission_errorКлюч отключён, просрочен, превысил лимит расходов или не имеет доступа к этой модели.
404not_found_errorЭтот ID модели недоступен. Проверьте написание по списку моделей.
429rate_limit_errorСлишком много запросов в минуту, или баланс занят выполняющимися запросами. Повторите через указанное число секунд.
502api_errorВышестоящий сервер временно недоступен. Повторите попытку.
10 /

Частые проблемы

401 или "invalid API key"

Скопируйте ключ целиком заново (он начинается с sk-ant-fai-), без пробела в конце. Проверьте, что ключ включён в личном кабинете.

404 или "model not found"

Указывайте ID модели точно как в списке моделей, например claude-sonnet-5-5. Не добавляйте перед ним название провайдера.

Инструмент не подключается

Проверьте, какой формат использует инструмент. Для формата Anthropic нужен https://api.fableaiapi.com без /v1. Для формата OpenAI нужен https://api.fableaiapi.com/v1. Не указывайте /messages или /chat/completions в поле Base URL.

Сразу приходит 429

Либо отправлено больше запросов в минуту, чем позволяет ключ, либо баланс небольшой и выполняются другие запросы. Подождите несколько секунд: инструменты повторяют запросы сами.

402: баланс пуст

Пополните баланс купоном на странице Баланс. Ключи снова работают сразу после зачисления.

11 /

Оплата

Баланс пополняется купонами. У каждой модели одна цена за миллион токенов. Входные, выходные и кэшированные токены считаются одинаково, плюс небольшая фиксированная надбавка вышестоящего сервера за каждый запрос.

Количество токенов в ответе API является оценкой. На странице Использование видны точные списанные токены и стоимость каждого запроса (окончательно примерно через минуту); данные можно выгрузить в CSV.

Нужно больше средств или более высокий лимит? Обратитесь к своему администратору.