Документація API та підключення IDE — Dikaya

Швидкий старт

Реєстрація за логіном і паролем без email: 8–128 символів пароля, введених двічі. Особистий ключ — у розділі «API та баланс». Новому відповідному акаунту може бути надано до 3 запитів seller-pro-2: текстовий Chat Completions, до 8192 токенів виходу разом із міркуванням, 6000 байтів контексту, 10 RPM і один одночасно. Старі квоти зберігаються, повторна реєстрація не поновлює демо.

Створити акаунт · API та баланс

У Base URL має бути рівно один /v1. Передавайте ключ через Authorization: Bearer dk_…. Приклади читають змінну середовища, а не містять справжній секрет. Автоповтори SDK вимкнено, щоб збій зв’язку непомітно не запустив новий платний запит. Перед ручним повтором перевірте стан і витрати. Демо не дозволяє агентні інструменти; після поповнення діють права ключа.

cURL

curl https://dikaya.cc/v1/chat/completions \
  -H "Authorization: Bearer $DIKAYA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seller-pro-2",
  "max_tokens": 8192,
  "messages": [
    {
      "role": "user",
      "content": "Запропонуй три перевірки для невеликого API."
    }
  ]
}'

Python · OpenAI SDK

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-pro-2",
    max_tokens=8192,
    messages=[{"role": "user", "content": "Запропонуй три перевірки для невеликого API."}],
)
print(response.choices[0].message.content)
print(response.usage)

JavaScript / TypeScript · OpenAI SDK

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://dikaya.cc/v1",
  apiKey: process.env.DIKAYA_API_KEY,
  maxRetries: 0,
});
const response = await client.chat.completions.create({
  model: "seller-pro-2",
  max_tokens: 8192,
  messages: [{ role: "user", content: "Запропонуй три перевірки для невеликого API." }],
});
console.log(response.choices[0].message.content);
console.log(response.usage);

Браузер: файли, пошук і гілки

Історія зберігається в акаунті. Пошук списку розмов фільтрує назви, а не повідомлення; приховування панелі нічого не видаляє. Збережена розмова повертає власні модель і налаштування. Нова починається з порожньої системної інструкції та типового міркування. Невикористані ненадіслані файли-чернетки спливають через 24 години й очищаються під час нових завантажень.

Розмови й версії відповідей зберігаються на сервері. Редагування запитання з генерацією створює гілку; повтор відповіді зберігає попередній варіант. Перегляд збереженої версії не запускає модель. «Стоп» зупиняє роботу, але не скасовує вже понесені витрати.

Платний чат приймає до чотирьох приватних файлів: текст/код UTF-8 до 32 КіБ кожен і 48000 байтів тексту разом або PNG/JPEG/WebP до 2 МіБ і 20 млн пікселів. Сховище акаунта — до 64 МіБ. Це не універсальне читання PDF чи довільних документів.

Пошук вмикається явно: пошуковики отримують видимий запит, а не приховану історію чи файли. До п’яти справжніх уривків зберігаються з відповіддю. Окремої доплати за пошук немає; уривки й відповідь використовують звичайні токени моделі. Помилка пошуку не запускає мовчки генерацію без джерел.

Чат

Налаштування й межі контексту

Платний чат підтримує системну інструкцію до 8000 символів, збережену для цієї розмови після прийнятого запиту, не глобально. low/high/max доступні лише за метаданими моделі; типове значення не надсилає reasoning_effort. Демо не змінює ці параметри. Responses використовує reasoning.effort. Міркування входить у вихідний бюджет і не оплачується вдруге.

Платний браузер надсилає до 40 повідомлень / 60000 байтів текстового JSON, демо — 24 / 5800, разом із системною інструкцією. Старі повідомлення можуть не надсилатися, але залишаються в історії. Це не точна кількість токенів. Окремо перевіряються контекст моделі, тіло API 16 МіБ та зображення; ліміти вкладень також чинні.

Панель API-запиту показує модель, історію та параметри з dk_YOUR_KEY, не розкриваючи секрет. Відкриття й копіювання нічого не надсилають. Для файлів/пошуку неповний текстовий cURL вимкнено: майбутні уривки й зображення не видаються за точно обчислений контекст. Код копіюється, завантажується й розгортається як текст, не виконується; Markdown не вбудовує виконуваний HTML або зовнішні картинки.

Підключення редактора

Потрібен клієнт з OpenAI-compatible / Custom API. OpenAI означає формат, запит іде в Dikaya й не потребує іншого ключа OpenAI. Перевірте /v1/models, /v1/balance і текстовий чат. Після поповнення окремо тестуйте невеликий проєкт та інструменти: клієнт може повторно пересилати історію й файли як платний вхід. Браузерний пошук не додає інтернет-інструмент до публічного API.

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

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

OpenCode V2

Встановіть OpenCode за офіційною інструкцією. Створіть opencode.jsonc у корені проєкту або додайте dikaya до наявного providers, зберігши інші налаштування. У V2 потрібні providers, package, settings.baseURL; приклади V1 з іншим синтаксисом не підходять. Секрет залишається у DIKAYA_API_KEY, а не в проєктному файлі.

{
  "$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"
        },
        "seller-glm-5-3": {
          "name": "GLM 5.3 Abliterated"
        },
        "seller-glm-5-3-flash": {
          "name": "GLM 5.3 Flash Abliterated"
        },
        "seller-qwen-3-8-flash-next": {
          "name": "Qwen3.8 Flash Next Abliterated"
        },
        "seller-deepseek-v4-1-flash": {
          "name": "DeepSeek V4.1 Flash Abliterated"
        },
        "seller-deepseek-v4-1-flash-1017": {
          "name": "DeepSeek V4.1 Flash 1017 (Safeguards)"
        }
      }
    }
  }
}

Задайте змінну в терміналі проєкту й запустіть opencode --standalone. Окремий сервер успадкує поточне середовище, тоді як раніше запущений спільний міг стартувати без ключа. Нижче — macOS/Linux та PowerShell. Через /models оберіть Dikaya і точний ID.

macOS / Linux

export DIKAYA_API_KEY="dk_YOUR_KEY"
opencode --standalone

Windows / PowerShell

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

Спершу попросіть пояснити структуру без змін. Якщо модель не з’явилась, перевірте каталог, JSON і середовище, перезапустіть цей екземпляр. Агентні завдання вимагають поповнення та дозволених інструментів. Великий контекст і повторні кроки не безкоштовні; стежте за витратами в акаунті.

Cursor: власний ключ

Відкрийте Cursor Settings → Models → API Keys: зазвичай Cmd+Shift+J на macOS або Ctrl+Shift+J на Windows/Linux. Вставте ключ Dikaya в OpenAI API Key, увімкніть Use OpenAI API Key та Override OpenAI Base URL з адресою нижче. Add Custom Model додає seller-pro-2; увімкніть його й оберіть у новому Ask-чаті. Можна додати інші дозволені ID.

Base URL: https://dikaya.cc/v1
API Key: dk_YOUR_KEY
Model ID: seller-pro-2

Назви залежать від версії; адміністратор команди може мати дозвіл на персональні ключі/BYOK. Cursor Tab не перемикається на Dikaya, Agent перевіряйте окремо. Якщо Verify тестує відсутню вбудовану модель, перевірте свій ID у чаті та cURL. Повертаючись до вбудованих моделей, вимкніть Override: деякі версії переспрямовують і їхні запити.

Continue / VS Code і JetBrains

Встановіть Continue, відкрийте налаштування моделей і локальний конфіг, зазвичай ~/.continue/config.yaml для YAML. Додайте модель, не видаляючи наявні; приклад нижче для платного доступу. Оберіть її в панелі та за потреби перезавантажте розширення. У демо потрібен текстовий режим і допустимий вихідний ліміт.

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. Ролі й інструменти залежать від версії Continue, а не лише від адреси API.

Cline / Roo Code

Встановіть розширення, відкрийте API-налаштування. Оберіть OpenAI Compatible або OpenAI з власним Base URL, задайте адресу, ключ і seller-pro-2. Платний приклад має 16384 вихідні токени разом із міркуванням. Збережіть, перевірте коротке запитання, потім пояснення одного файла невеликого проєкту.

Base URL: https://dikaya.cc/v1
API Key: dk_YOUR_KEY
Model ID: seller-pro-2

Агентний режим потребує поповнення; демо не дозволяє tool-виклики чи великий контекст. Схеми інструментів різняться між версіями. За помилки окремо перевірте текст, модель і формат tools. Більший вихідний ліміт потребує більшого резерву навіть для короткого питання.

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

Відкрийте термінал VS Code, JetBrains чи іншої IDE. ANTHROPIC_BASE_URL задається без /v1, шлях додає клієнт. ANTHROPIC_AUTH_TOKEN містить ключ Dikaya. seller-pro-2[1m] — сумісний суфікс контексту, незмінний API-ID — seller-pro-2. Агентний режим вимагає оплаченого доступу.

macOS / Linux

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

Windows / PowerShell

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

Змінні діють у цьому терміналі. Якщо запити йдуть не в Dikaya, перевірте середовище й налаштування проєкту на конфлікт адреси чи ключа. Це Messages, не обіцянка всіх внутрішніх розширень Claude: нові моделі приймають текст і звичайні function tools, непідтримувані розширення відхиляються до виконання.

Antigravity: OpenCode у терміналі

Офіційні матеріали не підтверджують довільний OpenAI Base URL для вбудованого агента Antigravity. Ключ Dikaya не замінює Google API key. Відкрийте проєкт і термінал Antigravity, встановіть OpenCode, додайте конфіг вище, задайте DIKAYA_API_KEY та запустіть opencode --standalone.

Оберіть модель через /models. OpenCode — окремий помічник для файлів проєкту, не заміна вбудованої моделі. Спосіб не змінює вхід Google, сертифікати чи внутрішні API. Не доручайте двом помічникам одночасно редагувати ті самі файли. Якщо з’явиться офіційний Custom Provider, користуйтеся документацією конкретної версії, а не припущенням.

OpenCode V2

Ендпоінти й протоколи

GET /v1/models повертає каталог, з ключем — дозволені моделі та персональні ціни; GET /v1/balance — баланс і ліміти. POST /v1/chat/completions — Chat Completions, POST /v1/responses — Responses, POST /v1/messages — Messages. Для SSE задайте stream: true; окремої ставки за стримінг немає.

GET  /v1/models
GET  /v1/balance
POST /v1/chat/completions
POST /v1/responses
POST /v1/messages

Нові моделі мають нативні Chat Completions і Responses. Messages адаптує текст і звичайні function tools; thinking/cache/media-розширення без підтримки відхиляються до резерву, не губляться мовчки. Зображення нових моделей використовують міст у Chat Completions/Responses. OpenAI-стрим запитує фінальний usage. Протокол не дає клієнту файлову систему або інструменти.

Актуальні моделі й роздрібні тарифи

Контекст і ціни нижче взяті з конфігурації. seller-pro-2 — доопрацьована GLM-5.3. Чотири нові GLM/Qwen/DeepSeek модифіковані, а DeepSeek V4.1 Flash 1017 (Safeguards) — окремий оригінальний варіант. Каталог не гарантує доступність: непідтверджений тариф обраної моделі зупиняє запит до генерації. reasoning_effort показує лише підтримувані значення.

Каталог не є перевіркою поточної доступності кожного варіанта. Діють дозволи ключа й перевірка тарифу; якщо умови не підтверджені, запит зупиняється до генерації. Особисті ціни перевіряй через /v1/models зі своїм ключем.

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": "user", "content": "Запропонуй три перевірки для невеликого API."}],
)
print(response.choices[0].message.content)
print(response.usage)

Резерв, usage та остаточні витрати

До моделі атомарно резервується консервативна оцінка входу й межі виходу. Відомий usage визначає фактичну вартість, решта звільняється. Ті самі кошти не можна двічі резервувати паралельно. Кеш входить у вхід, міркування — у вихід. Зображення може додати окремий етап; обидві вартості видно в історії.

Текстова оцінка: ((вхід − кеш) × ціна входу + кеш × ціна кешу + вихід × ціна виходу) / 1 000 000. Кеш уже входить до загального входу, міркування — до виходу, коли використовується. Зображення й додаткові запити можуть створювати окремі етапи.

Явна HTTP-відмова виконання повертає резерв. Обірване з’єднання, таймаут чи відсутній usage можуть статися після початку роботи: оцінка утримується до звірки. Втрата підтвердження не доводить відсутність збереження чи витрат. Закриття вкладки й «Стоп» не скасовують завершену роботу. Фінансові питання розглядаються вручну через підтримку, без автоматичного повернення.

Без явного ліміту клієнта пріоритет має особистий default ключа, інакше платний default 16384. Явний ліміт вище обох, максимум шлюзу — 65536 у межах моделі. Демо Pro 2 — до 8192, legacy Flash — 512; менша явна межа зберігається. Навіть додатний баланс може дати 402 через резерв: зменште контекст/вихід або поповніть.

Поповнення й рахунки

Чат і API мають спільні вільні кошти. В акаунті створіть рахунок для налаштованої доступної мережі: USDT TRON, TON, BNB Smart Chain, Ethereum або BTC за наявності гаманця. Створення рахунка не зараховує грошей. Він діє 30 хвилин; BTC фіксує курс при створенні та потребує трьох підтверджень. Автозарахування залежить від мережі й роботи моніторингу.

Надсилайте точну суму, комісію сплачуйте окремо. Не округлюйте ідентифікаційну добавку; баланс і бонус наведені в рахунку. Неправильна сума чи прострочення — через підтримку. Бонус залежить від одного підтвердженого платежу, не суми минулих оплат. Немає підписки, щомісячного списання чи згорання. Код активації дає окремий бюджет за своїми умовами, не підтверджує оплату й не дає пакетного бонусу.

Бонус визначає одна підтверджена оплата. Окремі платежі не підсумовуються для вищого рівня; створення рахунку не додає коштів. Індивідуальні й оптові умови не переоцінюють завершену історію.

Ціни · API та баланс

Помилки й відновлення

400: перевірте JSON, ID, вихід і демо. 401: відсутній, неправильний, відкликаний ключ або блокування. 402: бракує коштів для резерву. 404: Base URL і єдиний /v1, без нього для Claude Code. 429: ліміт ключа, зменште паралелізм і зачекайте. 502/503: виконання недоступне або умови не підтверджені; читайте error.message, type і code.

413 — тіло JSON понад 16 МіБ. Скоротіть історію, файли чи результати tools. Ця відмова за вхідною межею відбувається до генерації без списання, контекст перевіряється окремо. Велике вікно моделі не скасовує межу тіла або суворіші браузерні ліміти.

Відома HTTP-відмова й відсутня мережева відповідь — різні випадки. Не повторюйте POST автоматично за невідомого результату. У браузері перевірте прийнятий запуск; ручне відновлення використовує старий request ID. Новий API-запит або повтор SDK може стати новою платною роботою. Локальна помилка не доводить нульових витрат.

{"error":{"message":"…","type":"…","code":"…"}}

Зображення: пряме бачення та міст

seller-flash бачить зображення безпосередньо. Платні Pro/Pro 2 спочатку отримують опис Flash, потім обрана модель відповідає, без підміни. Обидва резерви обов’язкові до запуску й оплачуються окремо. Опис може втрачати деталі. Нові моделі використовують міст у Chat Completions/Responses, демо лише текстове.

До восьми різних зображень в API-запиті. data/base64 кешуються окремо для ключа на 24 години, повтор у історії не запускає аналіз знову. HTTP/HTTPS URL не кешуються через можливу зміну вмісту. Pro/Pro 2 мають міст у Chat Completions, Responses, Messages. Браузерний ліміт чотирьох вкладень суворіший.

X-Dikaya-Vision-Bridge, X-Dikaya-Vision-Cost-Usd, X-Dikaya-Vision-Cache-Hits показують міст. dikaya_image_handling: reject забороняє його та вимагає явної відмови на зображенні. Якщо аналіз не вдався, основна модель не запускається й її резерв повертається; завершений Flash оплачується, невідомий usage утримує оцінку. Це не читання довільних документів.

{
  "model": "seller-pro-2",
  "max_tokens": 1024,
  "dikaya_image_handling": "reject",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Запропонуй три перевірки для невеликого API."
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/png;base64,IMAGE_BYTES"
          }
        }
      ]
    }
  ]
}

Дані, ключі й доступ

Історія браузера зберігається на сервері. Запити, відповіді й витрати фіксуються для ручної модерації; адміністратор має захищену консоль і приватні Telegram-сповіщення. Потрібні матеріали передаються зовнішній інфраструктурі моделі. Не публікуйте ключ у фронтенді, репозиторії чи розмові. Перевипуск одразу відкликає старий секрет і зберігає баланс. Видалення не стирає автоматично фінансові/модераційні записи, сповіщення чи резервні копії. Політики наведені внизу.

Умови використання · Конфіденційність · Контакти

Часті запитання

HTTP 200 не гарантує непорожній message.content. Агент може повернути tool_calls, які клієнт має виконати та повернути. За finish_reason: length вихід міг закінчитися на міркуванні до фінального тексту. Дивіться причину й usage.completion_tokens_details.reasoning_tokens, не лише content. Не повторюйте обрізаний запит автоматично.

Для seller-flash Chat Completions міркування типово вимкнене без явного параметра; це не всі моделі з Flash у назві. Pro/Pro 2 мають власні режими. У демо Pro 2 reasoning_effort=none — низький рівень із прихованою трасою, не гарантія нуля токенів чи непорожнього тексту. Великий контекст не дорівнює довгому виходу.

RPM та вихідний ліміт вашого ключа — в акаунті й /v1/balance. Демо має 10 RPM і один одночасно; однакового обіцяного RPM для всіх платних ключів немає. Інструментам IDE потрібні підтримка, налаштування й дозволи; Base URL сам не дає файлів, інтернету чи команд.

Передплати немає, баланс не згорає. Питання щодо оплати, використання й доступу надсилай у підтримку акаунта. Розгляд ручний, без обіцянки автоматичного повернення чи строку відповіді. Окремий публічний канал відновлення пароля не опублікований, автоматичне відновлення не реалізоване.

Офіційні довідники клієнтів

Посилання пояснюють сторонні налаштування; інтерфейси й можливості залежать від версії. Довідник клієнта не розширює права ключа Dikaya. Приклади не виконуються, копіювання не надсилає запит. Практичні статті цією мовою — в окремому розділі.

• Python · OpenAI SDK
• JavaScript / TypeScript · OpenAI SDK
• OpenCode V2
• OpenCode V2 · opencode.jsonc
• OpenCode V2 · CLI
• Cursor: власний ключ
• Continue / VS Code і JetBrains
• Cline / Roo Code
• Roo Code
• Claude Code / термінал IDE
• Antigravity: OpenCode у терміналі

Статті