Документация Dikaya

Быстрый старт

Создайте аккаунт и проверьте доступность разового демо. Ваш ключ находится в разделе «API & баланс» в личном кабинете. Основная модель демо — Dikaya Pro 2 (seller-pro-2) через /v1/chat/completions: текст, до 8192 выходных токенов вместе с рассуждением и 6000 байт контекста. Чат и API используют один баланс. После пополнения доступны разрешённые ключу модели и инструменты.

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

Для новых подходящих аккаунтов демо: до 3 запросов. Пароль при регистрации: 8–128 символов, вводится дважды. Ранее выданные условия демо сохраняются.

База API: https://dikaya.cc/v1. Ключ передаётся в заголовке Authorization: Bearer dk_....

curl

curl https://dikaya.cc/v1/chat/completions \
  -H "Authorization: Bearer dk_..." \
  -H "Content-Type: application/json" \
  -d '{
     "model": "seller-pro-2",
     "max_tokens": 8192,
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    base_url="https://dikaya.cc/v1",
    api_key="dk_...",
    max_retries=0,
)

resp = client.chat.completions.create(
    model="seller-pro-2",
    max_tokens=8192,
    messages=[{"role": "user", "content": "Привет!"}],
)
print(resp.choices[0].message.content)

JavaScript / TypeScript

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://dikaya.cc/v1",
  apiKey: "dk_...",
  maxRetries: 0,
});

const resp = await client.chat.completions.create({
  model: "seller-pro-2",
  max_tokens: 8192,
  messages: [{ role: "user", content: "Привет!" }],
});
console.log(resp.choices[0].message.content);

Claude Code / терминал IDE

Откройте терминал VS Code или JetBrains. Замените ключ ниже на свой из кабинета. Для Pro 2 нужен пополненный баланс.

export ANTHROPIC_BASE_URL="https://dikaya.cc"
export ANTHROPIC_AUTH_TOKEN="dk_..."
claude --model 'seller-pro-2[1m]'

Здесь ANTHROPIC_BASE_URL указывается без /v1: клиент сам добавляет путь. Переменные действуют в текущем терминале. Если CLI отправляет запросы не в Dikaya, проверьте настройки окружения и проекта на конфликтующий адрес или ключ.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://dikaya.cc/v1",
    api_key=os.environ["DIKAYA_API_KEY"],
    max_retries=0,
)
response = client.chat.completions.create(
    model="seller-glm-5-3",
    max_tokens=1024,
    reasoning_effort="low",
    messages=[
        {"role": "system", "content": "Keep the answer concise."},
        {"role": "user", "content": "Suggest three acceptance tests for an API endpoint."},
    ],
)
print(response.choices[0].message.content)
print(response.usage)

Dikaya прямо в редакторе.

Используйте расширение с поддержкой OpenAI-compatible / Custom API. Название OpenAI в настройках означает формат протокола: запросы идут на адрес Dikaya, отдельный ключ другого сервиса не требуется.

1. Зарегистрируйтесь, откройте кабинет → API & баланс и скопируйте свой API-ключ.
2. Для проверки на демо выберите seller-pro-2, текстовый чат, максимум 8192 токенов вместе с рассуждением. Агент с инструментами требует пополнения.
3. Вставьте Base URL https://dikaya.cc/v1, свой ключ и точный ID модели.
4. Отправьте «Ответь одним словом: готово». Ответ и расход появятся в кабинете.

Для задач по коду рекомендуем Pro 2. Flash — для коротких вопросов и быстрых правок. Расширения могут многократно отправлять файлы и историю: это оплачиваемые входящие токены, даже если запрос выглядит коротким.

VS Code / JetBrains + Continue

1. Установите расширение Continue из магазина редактора.
2. Откройте панель Continue → настройки моделей → локальный конфиг. В версиях с YAML это обычно ~/.continue/config.yaml.
3. Добавьте модель ниже, сохранив остальные модели, если они уже настроены.
4. Выберите Dikaya Pro 2 в списке моделей и начните чат. При изменениях перезагрузите расширение.

name: Dikaya
version: 1.0.0
schema: v1
models:
  - name: Dikaya Pro 2
    provider: openai
    model: seller-pro-2
    apiBase: https://dikaya.cc/v1
    apiKey: YOUR_DIKAYA_KEY
    defaultCompletionOptions:
      maxTokens: 16384
  - name: Dikaya Flash
    provider: openai
    model: seller-flash
    apiBase: https://dikaya.cc/v1
    apiKey: YOUR_DIKAYA_KEY
    defaultCompletionOptions:
      maxTokens: 8192

Замените YOUR_DIKAYA_KEY в обоих местах. Это локальный конфиг с секретом — не включайте его в репозиторий. Если интерфейс вашей версии отличается, используйте ручное добавление OpenAI-совместимой модели с теми же URL и ID.

VS Code + Cline / Roo Code

1. Установите Cline или Roo Code и откройте настройки API в панели расширения.
2. Выберите OpenAI Compatible (в некоторых версиях — OpenAI с пользовательским Base URL).
3. Base URL: https://dikaya.cc/v1. API Key: ваш ключ Dikaya.
4. Model ID: seller-pro-2. Для платного доступа настройте лимит ответа 16384: рассуждение тоже расходует этот бюджет. Больший лимит требует большего предварительного резерва.
5. Сохраните и отправьте простой вопрос. Затем откройте небольшой проект и попросите объяснить один файл.

Для агентного режима сначала пополните баланс. Демонстрационный доступ не разрешает tool-вызовы и большой контекст. В разных версиях расширений схемы инструментов могут отличаться: если агент выдаёт ошибку несовместимого tool-вызова, проверьте текстовый чат и настройки модели отдельно.

OpenCode V2 — готовый конфиг Dikaya

Установите OpenCode по официальной инструкции. В каталоге проекта создайте opencode.jsonc. Если такой файл уже есть, добавьте блок Dikaya в существующий providers, не удаляя остальные настройки.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "dikaya/seller-pro-2",
  "providers": {
    "dikaya": {
      "name": "Dikaya",
      "env": ["DIKAYA_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://dikaya.cc/v1"
      },
      "models": {
        "seller-flash": { "name": "Dikaya Flash" },
        "seller-pro": { "name": "Dikaya Pro" },
        "seller-pro-2": { "name": "Dikaya Pro 2" }
      }
    }
  }
}

В терминале этого проекта задайте свой ключ. Приватный сервер --standalone гарантированно получает переменную из текущего терминала; уже запущенный общий сервер мог стартовать без неё.

macOS / Linux

export DIKAYA_API_KEY="dk_YOUR_KEY"
opencode --standalone

Windows / PowerShell

$env:DIKAYA_API_KEY = "dk_YOUR_KEY"
opencode --standalone

1. После запуска введите /models и выберите Dikaya Pro 2.
2. Проверьте запросом «Объясни структуру проекта, ничего не изменяй».
3. Смотрите расход в кабинете Dikaya. Агентные задачи требуют пополнения: демо предназначено для простого текстового чата.

В конфиге V2 используются providers, package и settings.baseURL. Не копируйте в него старые примеры V1 с другим форматом. Ключ не записывается в проектный файл; переменная действует в текущем терминале. Если Dikaya не появилась, проверьте каталог проекта, JSON и окружение, затем перезапустите этот экземпляр OpenCode. Справочник провайдеров V2 ↗

Cursor — свой ключ и своя модель

1. Откройте Cursor Settings → Models → API Keys. На macOS обычно Cmd + Shift + J, на Windows/Linux — Ctrl + Shift + J.
2. В поле OpenAI API Key вставьте ключ dk_… из кабинета и включите Use OpenAI API Key.
3. Включите Override OpenAI Base URL и укажите https://dikaya.cc/v1.
4. Через Add Custom Model добавьте seller-pro-2 и включите модель. При необходимости добавьте seller-pro и seller-flash.
5. Сохраните настройки, откройте новый чат, выберите seller-pro-2 и начните с обычного вопроса в режиме Ask.

Названия пунктов могут отличаться по версии Cursor. Custom key используется для чат-моделей; Tab / автодополнение не переключается на Dikaya. Работу Agent проверяйте отдельно для установленной версии — наличие custom chat не означает поддержку всех встроенных агентных функций.

Если API Keys скрыт в командной версии, администратору команды нужно разрешить персональные ключи и BYOK OpenAI. Если Verify пробует встроенный ID модели, которого нет в Dikaya, проверьте именно добавленную seller-pro-2 в чате и ключ через curl выше. При переключении обратно на встроенные модели Cursor выключайте Override Base URL: в некоторых версиях он перенаправляет и их запросы. Документация Cursor ↗

Google Antigravity — Dikaya в терминале проекта

В проверенной официальной документации Antigravity не описан штатный выбор произвольной модели с пользовательским OpenAI Base URL. Ключ Dikaya нельзя вставить вместо Google API key. Инструкция ниже запускает Dikaya внутри рабочего пространства через OpenCode, а не заменяет модель встроенного агента Antigravity.

1. Откройте проект в Antigravity и встроенный терминал.
2. Установите OpenCode и добавьте opencode.jsonc из раздела OpenCode V2 в корень этого проекта.
3. В терминале задайте DIKAYA_API_KEY командой для своей ОС и запустите opencode --standalone.
4. Выберите Dikaya Pro 2 через /models. Агент будет работать с файлами этого проекта; изменения видно в редакторе и системе контроля версий.

Этот способ не меняет вход в Google, сертификаты или внутренние API Antigravity. Встроенный агент и OpenCode — два отдельных помощника; не запускайте их одновременно на редактирование одних файлов. Если в вашей версии появится официальный Custom Provider, используйте URL https://dikaya.cc/v1, свой ключ и seller-pro-2. Официальная справка моделей ↗

Проверка ключа без IDE

curl https://dikaya.cc/v1/models \
  -H "Authorization: Bearer YOUR_DIKAYA_KEY"

curl https://dikaya.cc/v1/balance \
  -H "Authorization: Bearer YOUR_DIKAYA_KEY"

401 — неверный/старый ключ или блокировка; скопируйте актуальный ключ. 402 — пополните баланс. 400 — проверьте ID модели, лимит ответа и ограничения демо. 429 — снизьте параллелизм и повторите позже. 404 — проверьте Base URL: у OpenAI-совместимых клиентов ровно один /v1, у Claude Code — без него.

Привычный формат. Единый API.

Стриминг (SSE) поддерживается на всех POST-эндпоинтах: передай "stream": true. Токены списываются те же, что и без стрима.

Модели и цены

Цены указаны за 1 млн токенов. Кэшированные входные токены считаются по льготной ставке.

Баланс и оплата

Пакеты пополнения находятся на главной странице; создание счёта и история платежей — в кабинете.

• Перед запросом резервируется консервативная оценка стоимости контекста и заданного лимита ответа. После получения usage учитывается фактическая стоимость, неиспользованная часть резерва возвращается. Чат и API используют один свободный баланс.
• Формула: (вход − кэш) × цена_входа + кэш × цена_кэша + выход × цена_выхода. Двойного списания за кэш нет.
• При явном отказе модели (HTTP-ошибка) резерв возвращается полностью. При обрыве соединения/таймауте или отсутствии usage выполнение уже могло начаться: сохраняется оценочное списание в пределах резерва. Закрытие вкладки не отменяет учёт уже выполняющегося запроса.
• Если свободного баланса недостаточно для резерва, новый запрос получает 402. Уменьшите контекст/лимит ответа или пополните баланс. Одни и те же средства нельзя резервировать параллельно дважды.
• Платный API: лимит ответа по умолчанию 16384, максимально 65536 токенов (модель может иметь меньший собственный предел). Личный default ключа и явный лимит клиента имеют приоритет; демо Pro 2 — до 8192. Для медиа резерв выше, поскольку размер изображения/файла не определяется длиной URL. Указание небольшого max_tokens уменьшает необходимый резерв.
• У новых моделей GLM/Qwen/DeepSeek доступны reasoning_effort: low, high, max. Отсутствие параметра сохраняет default модели. Рассуждение входит в выходной бюджет. В Responses используйте reasoning.effort. Messages для этих моделей поддерживает текст и обычные function-инструменты; thinking/cache/media-расширения отклоняются до запуска. Изображения через мост доступны в Chat Completions и Responses. Полный доступный вашему ключу каталог: GET /v1/models с авторизацией.
• Текущий остаток — GET /v1/balance. В кабинете выберите пакет, сеть и получите счёт с точной суммой. Оплата зачисляется автоматически после подтверждения сетью, если кошелёк подключён и мониторинг работает.
• Доступны USDT в TRON, TON, BNB Smart Chain и Ethereum, а также BTC — после добавления соответствующих кошельков администратором. Счёт действителен 30 минут. Для BTC курс фиксируется при создании счёта; требуются 3 подтверждения.
• Отправляйте точную сумму и оплачивайте комиссию сети отдельно. Небольшая идентификационная добавка нужна для распознавания оплаты; баланс и бонус указаны в счёте. Не округляйте сумму. Просроченный или неточный платёж — через поддержку.
• Баланс не сгорает. Подписки и автоматических ежемесячных списаний нет. Бонус начисляется по сумме одного подтверждённого платежа.

Если что-то пошло не так.

Формат ошибок — OpenAI-совместимый: {"error": {"message", "type", "code"}}, поэтому стандартные SDK разбирают их сами.

Хорошие вопросы. Короткие ответы.

Почему HTTP 200, но текста ответа нет?

В агентном режиме ответ может содержать tool_calls, а не текст: клиент IDE должен выполнить инструмент и продолжить диалог. Также при finish_reason: length лимит выхода мог закончиться на рассуждении до финального текста. Смотрите причину завершения и usage.completion_tokens_details.reasoning_tokens, а не только message.content.

Для Dikaya Flash (seller-flash) через Chat Completions рассуждение по умолчанию выключено, если вы не задали его явно. Это не default новых моделей с Flash в названии. Pro/Pro 2 сохраняют выбранный режим. Выходные токены включают рассуждение, когда оно включено; оно не тарифицируется второй раз отдельно. Для сложных задач задавайте достаточный лимит ответа и не повторяйте обрезанный запрос автоматически без проверки расхода.

Изображения в Pro и Pro 2

У Pro/Pro 2 нет собственного зрения. На платном доступе Dikaya сначала получает текстовое описание картинки через Flash, затем передаёт описание выбранной Pro-модели. Модель ответа не подменяется. Это два оплачиваемых этапа: токены Flash и основной модели учитываются отдельно в истории расходов, а в журнале запроса показывается суммарная стоимость. До начала обработки резервируются средства на оба этапа.

Встроенные data/base64-изображения кэшируются отдельно для каждого ключа на 24 часа: повтор того же изображения в истории не запускает новый Flash-разбор. HTTP/HTTPS URL не кэшируются, поскольку содержимое по ссылке может измениться. Поддерживаются Chat Completions, Responses и Anthropic Messages, до 8 разных изображений в запросе. Демонстрационный доступ остаётся текстовым.

Заголовки X-Dikaya-Vision-Bridge, X-Dikaya-Vision-Cost-Usd и X-Dikaya-Vision-Cache-Hits показывают дополнительную обработку. Чтобы запретить мост и получать явный отказ на изображениях, передайте "dikaya_image_handling": "reject". При сбое обработки основная модель не запускается: её резерв возвращается; уже выполненный Flash-разбор оплачивается, а при неизвестном usage удерживается оценочный резерв. Описание может не сохранить все визуальные детали; для непосредственной работы с изображением выбирайте Flash.

Работает ли стриминг?

Да, SSE проходит насквозь без задержки. Для OpenAI-формата шлюз сам включает stream_options.include_usage, чтобы получить финальный usage.

Какой rate limit у моего ключа?

Лимит задаётся для конкретного ключа и виден в /v1/balance и кабинете. В демо — 10 запросов в минуту. После пополнения смотрите действующее значение вашего ключа: единого обещанного лимита для всех платных аккаунтов нет.

Куда идут мои данные?

Запросы обрабатываются сервером Dikaya и передаются сервису исполнения модели. История браузерных чатов хранится в вашем кабинете. Для ручной модерации сохраняются вопрос, ответ и сведения о запросе; они доступны администратору в защищённой консоли и его приватном Telegram-боте. Публичного доступа к журналам нет. Не отправляйте в диалог пароли или приватные ключи.