Tài liệu API và kết nối IDE — Dikaya

Bắt đầu nhanh

Đăng ký tên đăng nhập và mật khẩu, không email. Mật khẩu 8–128 ký tự, nhập hai lần. Khóa cá nhân nằm ở API và số dư. Tài khoản mới đủ điều kiện có thể nhận tối đa 3 yêu cầu seller-pro-2: Chat Completions văn bản, 8192 token đầu ra kể cả suy luận, 6000 byte ngữ cảnh, 10 RPM và một yêu cầu đồng thời. Hạn mức cũ được giữ; đăng ký lại không cấp lại dùng thử.

Tạo tài khoản · API và số dư

Base URL có đúng một /v1; gửi Authorization: Bearer dk_…. Ví dụ đọc biến môi trường, không nhúng khóa thật. Đã tắt tự thử lại trong SDK để tránh phát sinh yêu cầu trả phí mới sau mất kết nối. Kiểm tra trạng thái và chi phí trước khi gửi lại thủ công. Bản thử không cho công cụ tác tử; sau nạp tiền vẫn theo quyền của khóa.

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": "Đề xuất ba kiểm tra cho một API nhỏ."
    }
  ]
}'

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": "Đề xuất ba kiểm tra cho một API nhỏ."}],
)
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: "Đề xuất ba kiểm tra cho một API nhỏ." }],
});
console.log(response.choices[0].message.content);
console.log(response.usage);

Trình duyệt: tệp, tìm kiếm và nhánh

Lịch sử được lưu trong tài khoản. Tìm hội thoại lọc tiêu đề, không tìm nội dung; ẩn bảng không xóa lịch sử. Hội thoại cũ khôi phục mô hình và thiết lập riêng. Hội thoại mới có chỉ dẫn hệ thống rỗng, suy luận mặc định. Tệp nháp chưa gửi và chưa dùng hết hạn sau 24 giờ, được dọn khi tải tệp mới.

Hội thoại và phiên bản được lưu trên máy chủ. Sửa câu hỏi rồi tạo đáp án sẽ tạo nhánh; tạo lại vẫn giữ đáp án cũ. Xem phiên bản đã lưu không gọi mô hình. Dừng chỉ ngừng công việc, không hủy chi phí đã phát sinh.

Trò chuyện trả phí nhận tối đa bốn tệp riêng tư: văn bản/mã UTF-8 tối đa 32 KiB mỗi tệp, tổng văn bản 48000 byte; hoặc PNG/JPEG/WebP tối đa 2 MiB và 20 triệu điểm ảnh mỗi ảnh. Bộ nhớ tài khoản tối đa 64 MiB. Đây không phải trình đọc mọi PDF hay tài liệu.

Tìm kiếm cần được bật rõ ràng. Công cụ tìm kiếm nhận truy vấn hiển thị, không nhận lịch sử ẩn hoặc tệp. Tối đa năm trích đoạn thật được lưu cùng câu trả lời. Không có phụ phí tìm kiếm; trích đoạn và đáp án dùng token mô hình thông thường. Lỗi tìm kiếm không âm thầm chuyển sang tạo đáp án không nguồn.

Trò chuyện

Thiết lập và giới hạn ngữ cảnh

Chat trả phí cho chỉ dẫn hệ thống tối đa 8000 ký tự, lưu theo hội thoại sau yêu cầu được chấp nhận, không dùng toàn cục. low/high/max chỉ xuất hiện theo siêu dữ liệu hỗ trợ; mặc định không gửi reasoning_effort. Bản thử không đổi được. Responses dùng reasoning.effort. Suy luận tính vào ngân sách đầu ra, không thu lần hai.

Trình duyệt trả phí gửi tối đa 40 tin / 60000 byte JSON văn bản, bản thử 24 / 5800, kể cả chỉ dẫn hệ thống. Có thể bỏ ngữ cảnh cũ khỏi yêu cầu mà không xóa lịch sử. Đây không phải số token chính xác. Ngữ cảnh mô hình, thân API 16 MiB và ngân sách ảnh kiểm tra riêng; còn giới hạn tệp đính kèm.

Bảng yêu cầu API xem trước mô hình, lịch sử và tùy chọn bằng dk_YOUR_KEY, không lộ khóa. Mở hoặc sao chép không gửi gì. Khi có tệp/tìm kiếm, cURL thuần văn bản chưa đủ bị vô hiệu hóa; không coi trích đoạn tương lai hay ảnh là ngữ cảnh đã đếm chính xác. Mã được sao chép, tải và mở rộng như văn bản, không thực thi. Markdown không nhúng HTML chạy được hoặc ảnh bên ngoài.

Kết nối trình soạn thảo

Cần OpenAI-compatible / Custom API. OpenAI chỉ giao thức, đích là Dikaya; không cần khóa OpenAI riêng. Thử /v1/models, /v1/balance rồi văn bản. Sau nạp, thử dự án nhỏ và công cụ riêng: gửi lại lịch sử/tệp là đầu vào có phí. Tìm kiếm trình duyệt không thêm công cụ internet cho API công khai.

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

Cài OpenCode theo hướng dẫn chính thức. Tạo opencode.jsonc ở gốc hoặc ghép dikaya vào providers có sẵn, giữ thiết lập khác. V2 dùng providers, package, settings.baseURL, không phải cú pháp V1 cũ. Giữ bí mật trong DIKAYA_API_KEY, không trong tệp dự án.

{
  "$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)"
        }
      }
    }
  }
}

Đặt biến tại terminal dự án và chạy opencode --standalone. Máy chủ riêng nhận môi trường hiện tại; máy chủ dùng chung đã chạy có thể thiếu khóa. Dưới có macOS/Linux và PowerShell. Chọn Dikaya và ID chính xác bằng /models.

macOS / Linux

export DIKAYA_API_KEY="dk_YOUR_KEY"
opencode --standalone

Windows / PowerShell

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

Bắt đầu bằng yêu cầu giải thích dự án, không sửa. Thiếu mô hình thì kiểm tra thư mục, JSON, môi trường và khởi động lại phiên đó. Tác tử cần số dư và công cụ được phép. Theo dõi chi phí vì ngữ cảnh lớn, nhiều bước không miễn phí.

Cursor: khóa của bạn

Mở Cursor Settings → Models → API Keys, thường Cmd+Shift+J trên macOS hoặc Ctrl+Shift+J trên Windows/Linux. Điền khóa Dikaya vào OpenAI API Key và bật Use OpenAI API Key. Bật Override OpenAI Base URL với địa chỉ dưới. Add Custom Model thêm seller-pro-2, bật và chọn trong chat Ask mới. Có thể thêm ID khác được phép.

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

Tên mục thay đổi theo phiên bản; quản trị nhóm có thể cần cho khóa cá nhân/BYOK. Cursor Tab không chuyển sang Dikaya; kiểm tra Agent riêng. Nếu Verify gọi mô hình tích hợp không có, thử ID của bạn bằng chat và cURL. Tắt Override khi trở lại mô hình tích hợp vì một số bản cũng chuyển hướng chúng.

Continue / VS Code và JetBrains

Cài Continue, mở thiết lập mô hình và cấu hình cục bộ, thường ~/.continue/config.yaml cho YAML. Thêm mô hình mà giữ mục cũ; cấu hình dưới dành cho trả phí. Chọn trong bảng và nạp lại tiện ích nếu cần. Bản thử dùng văn bản và giới hạn đầu ra được phép.

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

Chỉ thay YOUR_DIKAYA_KEY trong tệp cục bộ, không đưa bí mật lên kho mã. Nếu giao diện khác, thêm thủ công mô hình tương thích OpenAI với cùng URL và ID. Vai trò và công cụ tùy phiên bản Continue, không chỉ địa chỉ API.

Cline / Roo Code

Cài tiện ích, mở thiết lập API. Chọn OpenAI Compatible hoặc OpenAI có Base URL riêng, điền địa chỉ, khóa và seller-pro-2. Ví dụ trả phí có 16384 token đầu ra kể cả suy luận. Lưu, thử câu ngắn rồi giải thích một tệp trong dự án nhỏ.

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

Chế độ tác tử cần nạp tiền; bản thử không hỗ trợ gọi công cụ hay ngữ cảnh lớn. Lược đồ tools khác giữa các phiên bản. Khi lỗi, kiểm tra văn bản, mô hình và định dạng tools riêng. Giới hạn đầu ra lớn cần giữ trước nhiều tiền hơn ngay cả câu hỏi ngắn.

Claude Code / terminal IDE

Mở terminal VS Code, JetBrains hoặc khác. ANTHROPIC_BASE_URL không có /v1 vì client tự thêm đường dẫn. ANTHROPIC_AUTH_TOKEN chứa khóa Dikaya. seller-pro-2[1m] dùng hậu tố ngữ cảnh tương thích; API ID vẫn seller-pro-2. Tác tử cần truy cập trả phí.

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]'

Biến chỉ áp dụng terminal hiện tại. Nếu yêu cầu đi chỗ khác, kiểm tra khóa/địa chỉ xung đột trong môi trường và dự án. Đây là kết nối Messages, không bảo đảm mọi mở rộng nội bộ Claude. Mô hình mới nhận văn bản và function tools thông thường; phần không hỗ trợ bị từ chối trước thực thi.

Antigravity: OpenCode trong terminal

Tài liệu chính thức chưa xác nhận Base URL OpenAI tùy ý cho tác tử tích hợp Antigravity. Khóa Dikaya không thay Google API key. Mở dự án và terminal, cài OpenCode, thêm cấu hình trên, đặt DIKAYA_API_KEY, chạy opencode --standalone.

Chọn qua /models. OpenCode là trợ lý riêng thao tác tệp, không thay mô hình tích hợp, không đổi đăng nhập Google, chứng chỉ hay API nội bộ. Không để hai trợ lý sửa cùng tệp đồng thời. Nếu có Custom Provider chính thức, theo tài liệu phiên bản đó thay vì giả định hỗ trợ.

OpenCode V2

Endpoint và giao thức

GET /v1/models trả danh mục, có khóa thì mô hình được phép và giá cá nhân; GET /v1/balance trả số dư và giới hạn. POST /v1/chat/completions dùng Chat Completions, POST /v1/responses dùng Responses, POST /v1/messages dùng Messages. Đặt stream: true cho SSE, không có giá token riêng cho luồng.

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

Mô hình mới dùng Chat Completions và Responses gốc. Messages chuyển văn bản, function tools thường; thinking/cache/media không hỗ trợ bị từ chối trước giữ tiền, không âm thầm bỏ. Ảnh của mô hình mới dùng cầu nối trong Chat Completions/Responses. Luồng OpenAI yêu cầu usage cuối. Giao thức không tự cấp hệ thống tệp hay công cụ cho client.

Mô hình hiện tại và giá bán lẻ

Ngữ cảnh, giá dưới lấy từ cấu hình. seller-pro-2 là GLM-5.3 chỉnh sửa. Bốn biến thể mới GLM/Qwen/DeepSeek được chỉnh sửa; DeepSeek V4.1 Flash 1017 (Safeguards) là bản gốc riêng. Danh mục không chứng minh đang khả dụng: giá chưa xác nhận sẽ dừng trước tạo. reasoning_effort chỉ hiện giá trị hỗ trợ.

Danh mục không phải phép thử tính sẵn sàng theo thời gian thực. Quyền của khóa và kiểm tra giá được áp dụng; điều kiện chưa xác nhận sẽ dừng yêu cầu trước khi tạo nội dung. Xem giá riêng qua /v1/models bằng khóa của bạn.

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": "Đề xuất ba kiểm tra cho một API nhỏ."}],
)
print(response.choices[0].message.content)
print(response.usage)

Giữ tiền, usage và chi phí cuối

Trước xử lý, ước tính thận trọng đầu vào và đầu ra tối đa được giữ theo giao dịch nguyên tử. usage biết rõ quyết toán thực tế và nhả phần thừa; một số dư không tài trợ hai lần giữ đồng thời. Bộ nhớ đệm nằm trong đầu vào, suy luận trong đầu ra. Ảnh có thể thêm giai đoạn, cả hai hiện trong lịch sử.

Ước tính văn bản: ((đầu vào − bộ nhớ đệm) × giá đầu vào + bộ nhớ đệm × giá bộ nhớ đệm + đầu ra × giá đầu ra) / 1.000.000. Bộ nhớ đệm đã nằm trong tổng đầu vào; suy luận thuộc đầu ra khi được dùng. Ảnh và yêu cầu bổ sung có thể thêm giai đoạn riêng.

Từ chối HTTP thực thi rõ ràng giải phóng khoản giữ. Mất mạng, quá thời gian hoặc thiếu usage có thể sau khi việc bắt đầu: giữ ước tính để đối soát. Mất xác nhận không chứng minh chưa lưu hay miễn phí. Đóng tab hoặc dừng không xóa việc đã làm. Tranh chấp tài chính được hỗ trợ tài khoản xét thủ công, không hứa hoàn tự động.

Nếu client không cho giới hạn, ưu tiên mặc định cá nhân của khóa, nếu không dùng mặc định trả phí 16384. Giới hạn rõ ràng của client thắng cả hai; gateway tối đa 65536 theo mô hình. Pro 2 thử tối đa 8192, Flash cũ 512; giới hạn nhỏ hơn vẫn giữ. Số dư dương vẫn có thể 402 do giữ trước lớn: giảm ngữ cảnh/đầu ra hoặc nạp.

Nạp tiền và hóa đơn

Chat và API chung tiền khả dụng. Tạo hóa đơn mạng được cấu hình và khả dụng: USDT TRON, TON, BNB Smart Chain, Ethereum hoặc BTC khi có ví. Tạo hóa đơn không cộng tiền. Hạn 30 phút; BTC chốt tỷ giá lúc tạo, cần ba xác nhận. Tự cộng phụ thuộc xác nhận và giám sát hoạt động.

Gửi đúng số tiền, trả phí mạng riêng. Không làm tròn phần tăng nhận dạng; số dư và thưởng ở hóa đơn. Sai tiền hoặc trễ cần hỗ trợ. Thưởng theo một thanh toán xác nhận, không cộng lịch sử. Không thuê bao, trừ tháng tự động hay hết hạn. Mã kích hoạt cấp ngân sách riêng theo điều kiện, không chứng minh thanh toán hay có thưởng gói.

Thưởng dựa trên một thanh toán đã xác nhận. Các thanh toán riêng không cộng dồn để lên mức cao hơn; tạo hóa đơn không cộng tiền. Điều kiện cá nhân hay bán buôn không tính lại lịch sử đã hoàn tất.

Giá · API và số dư

Lỗi và khôi phục

400: kiểm JSON, ID, đầu ra, bản thử. 401: khóa thiếu, sai, thu hồi hoặc bị chặn. 402: tiền khả dụng không đủ giữ. 404: Base URL và đúng một /v1, Claude Code không có. 429: giới hạn khóa, giảm đồng thời và chờ. 502/503: xử lý không khả dụng hoặc điều kiện chưa xác nhận; đọc error.message, type, code.

413 nghĩa thân JSON quá 16 MiB. Giảm lịch sử, tệp hoặc kết quả công cụ. Từ chối giới hạn đầu vào này trước tạo, không trừ số dư; ngữ cảnh mô hình kiểm riêng. Cửa sổ lớn không bỏ giới hạn thân hay trình duyệt.

Từ chối HTTP biết rõ khác phản hồi mạng bị mất. Không tự thử POST khi kết quả chưa rõ. Kiểm run đã nhận trong trình duyệt; khôi phục thủ công dùng request ID cũ. API mới hay SDK thử lại có thể là việc trả phí mới. Ngoại lệ cục bộ không chứng minh chi phí bằng không.

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

Ảnh: thị giác gốc và cầu nối

seller-flash xử lý ảnh trực tiếp. Pro/Pro 2 trả phí nhận mô tả Flash trước, rồi mô hình đã chọn trả lời, không thay nó. Cần hai khoản giữ trước, tính riêng. Mô tả có thể mất chi tiết. Mô hình mới dùng cầu nối Chat Completions/Responses, bản thử chỉ văn bản.

Tối đa tám ảnh khác nhau mỗi yêu cầu API. data/base64 được lưu đệm theo khóa 24 giờ, lặp trong lịch sử không phân tích lại. URL HTTP/HTTPS không lưu đệm vì nội dung đổi. Pro/Pro 2 có cầu nối Chat Completions, Responses, Messages. Bốn tệp của trình duyệt là giới hạn chặt hơn.

X-Dikaya-Vision-Bridge, X-Dikaya-Vision-Cost-Usd, X-Dikaya-Vision-Cache-Hits báo cầu nối. dikaya_image_handling: reject tắt và yêu cầu từ chối ảnh rõ ràng. Lỗi phân tích không chạy mô hình chính và trả khoản giữ của nó; Flash đã xong vẫn tính, usage chưa rõ giữ ước tính. Hỗ trợ ảnh không là đọc mọi tài liệu.

{
  "model": "seller-pro-2",
  "max_tokens": 1024,
  "dikaya_image_handling": "reject",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Đề xuất ba kiểm tra cho một API nhỏ."
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/png;base64,IMAGE_BYTES"
          }
        }
      ]
    }
  ]
}

Dữ liệu, khóa và quyền

Lịch sử ở máy chủ. Câu hỏi, đáp án, chi phí được lưu để kiểm duyệt thủ công; quản trị có bảng bảo vệ và thông báo Telegram riêng. Tài liệu cần thiết gửi tới hạ tầng mô hình bên ngoài. Không để khóa trong frontend, kho mã, hội thoại. Đổi khóa thu hồi bí mật cũ ngay, giữ số dư. Xóa không tự xóa hồ sơ tài chính/kiểm duyệt riêng, thông báo, bản sao lưu. Xem điều khoản và riêng tư bên dưới.

Điều khoản sử dụng · Quyền riêng tư · Liên hệ

Câu hỏi thường gặp

HTTP 200 không đảm bảo message.content có chữ. Tác tử có thể trả tool_calls để client thực thi và gửi lại. finish_reason: length có thể do suy luận hết đầu ra trước văn bản. Xem lý do và usage.completion_tokens_details.reasoning_tokens, không chỉ content. Không tự chạy lại yêu cầu bị cắt.

seller-flash Chat Completions tắt suy luận mặc định trừ khi chỉ rõ; không phải mọi mô hình tên Flash. Pro/Pro 2 giữ chế độ riêng. reasoning_effort=none của Pro 2 thử là suy luận thấp với vết ẩn, không bảo đảm không token suy luận hay trả lời có chữ. Ngữ cảnh lớn không nghĩa đầu ra dài bằng.

Tài khoản và /v1/balance cho RPM, giới hạn đầu ra của khóa. Bản thử 10 RPM và một đồng thời; không hứa RPM chung cho mọi khóa trả phí. Công cụ IDE cần hỗ trợ, cấu hình, quyền; Base URL không tự cho tệp cục bộ, mạng hay lệnh.

Không thuê bao, số dư không hết hạn. Dùng hỗ trợ trong tài khoản cho thanh toán, tiêu thụ và truy cập. Xem xét thủ công, không hứa hoàn tiền tự động hay thời hạn trả lời. Chưa công bố kênh công khai riêng để lấy lại mật khẩu và chưa có khôi phục tự động.

Tham khảo chính thức của client

Các liên kết giải thích công cụ bên ngoài, giao diện thay đổi theo phiên bản. Tài liệu client không mở rộng quyền khóa Dikaya. Ví dụ không thực thi; sao chép không gửi. Bài thực hành của phiên bản ngôn ngữ này có mục riêng.

• Python · OpenAI SDK
• JavaScript / TypeScript · OpenAI SDK
• OpenCode V2
• OpenCode V2 · opencode.jsonc
• OpenCode V2 · CLI
• Cursor: khóa của bạn
• Continue / VS Code và JetBrains
• Cline / Roo Code
• Roo Code
• Claude Code / terminal IDE
• Antigravity: OpenCode trong terminal

Bài viết