API 文档与 IDE 配置 — Dikaya

审核日期 2026年10月23日

先验证文本请求，再连接编辑器。这里提供可用配置、浏览器聊天边界、费用结算规则，以及结果未知时的处理区别。

快速开始

使用用户名和密码注册，无需邮箱；密码为 8–128 个字符，需输入两次。在“API 与余额”取得个人密钥。符合条件的新账户最多可获 3 次 seller-pro-2 请求：文本 Chat Completions，输出最多 8192 个 token（含推理），上下文 6000 字节，每分钟 10 次、同时一次。旧配额不变，重复注册不会获得新试用。

创建账户 · 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 KiB，文本总计 48000 字节；PNG/JPEG/WebP 每个最多 2 MiB、2000 万像素。每账户存储上限 64 MiB。不支持任意 PDF 或所有文档格式。

搜索需明确开启。搜索引擎只接收可见查询，不接收隐藏历史或文件。最多五段真实摘要与回答一同保存。不另收搜索附加费，摘要和回答按普通模型 token 计费。搜索失败不会悄悄改成无来源生成。

聊天

设置与上下文边界

付费聊天的系统提示最多 8000 字符，在请求被接受后保存到当前会话，而不是全局设置。只有模型元数据支持时才显示 low/high/max；默认不发送 reasoning_effort。试用不能修改这些设置。Responses 使用 reasoning.effort。推理消耗输出预算，不再重复收费。

浏览器付费文本最多发送 40 条消息、60000 字节 JSON；试用为 24 条、5800 字节，包含系统提示。较早内容可能不再发送，但仍在已保存历史中。这不是精确 token 数。模型上下文、16 MiB API 请求体和图像预算单独校验，附件另有限制。

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，通常 macOS 为 Cmd+Shift+J，Windows/Linux 为 Ctrl+Shift+J。把 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，打开模型设置和本地配置；YAML 版本通常使用 ~/.continue/config.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 替换成密钥，不要提交到仓库。如果版本界面不同，可用相同 URL 和 ID 手动添加 OpenAI 兼容模型。角色与工具支持取决于 Continue 版本，不是只填 API 地址就能获得。

Cline / Roo Code

安装扩展并进入 API 设置。选择 OpenAI Compatible（有时为带自定义 Base URL 的 OpenAI），填写地址、密钥和 seller-pro-2。付费示例使用 16384 个输出 token，包含推理。保存后先测短问题，再解释小项目中的一个文件。

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

智能体模式需要充值；试用不允许工具调用或大上下文。不同扩展版本的工具结构可能不同。工具报错时分别检查文本请求、模型选择和 tools 格式。即使问题很短，更大输出上限也需要更大预留额。

Claude Code / IDE 终端

打开 VS Code、JetBrains 或其他终端。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

官方文档未确认内置 Antigravity 智能体能任意设置 OpenAI Base URL。Dikaya 密钥不是 Google API key。打开项目和 Antigravity 终端，安装 OpenCode，加入上方配置，设置 DIKAYA_API_KEY，再运行 opencode --standalone。

通过 /models 选择模型。OpenCode 是操作项目文件的独立助手，不替换 Antigravity 内置模型，不改变 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。设置 stream: true 使用 SSE，流式输出没有单独 token 费率。

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 只展示实际支持值。

每百万 token，美元
模型	API ID	上下文，token	图像处理	输入	缓存输入	输出	`reasoning_effort`
Dikaya Flash	`seller-flash`	256,000	直接处理	2	0.2	6	—
Dikaya Pro	`seller-pro`	1,000,000	通过文本描述	6	0.6	10	—
Dikaya Pro 2	`seller-pro-2`	1,000,000	通过文本描述	6	0.6	10	—
GLM 5.3 Abliterated	`seller-glm-5-3`	1,048,576	通过文本描述	4	0.7	6	low / high / max
GLM 5.3 Flash Abliterated	`seller-glm-5-3-flash`	1,048,576	通过文本描述	0.5	0.3	1.6	low / high / max
Qwen3.8 Flash Next Abliterated	`seller-qwen-3-8-flash-next`	262,144	通过文本描述	0.36	0.18	1.2	low / high / max
DeepSeek V4.1 Flash Abliterated	`seller-deepseek-v4-1-flash`	1,048,576	通过文本描述	1.2	0.3	3.2	low / high / max
DeepSeek V4.1 Flash 1017 (Safeguards)	`seller-deepseek-v4-1-flash-1017`	1,048,576	通过文本描述	0.1	0.008	0.3	low / high / max

目录不是每个版本的实时可用性测试。请求受密钥权限和价格校验约束；条件无法确认时会在生成前停止。使用自己的密钥查询 /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。缓存已计入总输入；使用推理时，其 token 计入输出。图像与额外请求可能产生独立处理阶段。

明确的执行 HTTP 拒绝会释放预留。断网、超时或缺失 usage 时，工作可能已经开始，估算预留会保留等待核对。确认丢失不证明请求未保存，也不证明免费。关闭标签页或点击停止不会撤销已完成工作。财务争议通过账户支持人工审核，不保证自动退款。

客户端未指定上限时优先使用密钥个人默认值，否则使用付费网关默认 16384。客户端显式上限优先于两者，网关最高 65536，仍受模型限制。Pro 2 试用最多 8192，旧 Flash 为 512；较小显式上限保留。余额为正也可能因预留不足报 402，可缩短上下文、输出或充值。

充值与账单

聊天和 API 共用可用余额。在账户为已配置且可用的网络创建账单：TRON、TON、BNB Smart Chain、Ethereum 的 USDT，或配置钱包后的 BTC。创建账单不会到账。有效期 30 分钟；BTC 创建时锁定汇率，需三次确认。自动到账依赖链确认与正常监控。

按精确金额转账，网络手续费另外支付。不要抹去识别附加额；预计到账与赠送以账单为准。金额不符或逾期请联系支持。赠送取决于单笔确认付款，不能累计历史付款升级。无订阅、月度自动扣费或余额到期。激活码按自身条件发放独立预算，不代表付款确认，也不产生套餐赠送。

套餐	支付，美元	到账额度，美元	赠送比例
Start	5	5	0%
Builder	20	21	5%
Studio	50	55	10%
Scale	100	115	15%

赠送比例按单笔已确认付款计算。不同付款不会合并升级，创建账单不会增加余额。个人或批发条件不会重新计算已完成的历史费用。

价格 · API 与余额

错误与恢复

400：检查 JSON、模型 ID、输出与试用限制。401：密钥缺失、错误、撤销或账户被封。402：可用余额不足以预留。404：检查 Base URL 和唯一 /v1，Claude Code 不加它。429：密钥限频，降低并发并等待。502/503：执行不可用或条件未确认，请读取 error.message、type、code。

413 表示 JSON 请求体超过 16 MiB。请减少历史、附件或工具结果。此输入上限拒绝发生在生成前，不扣余额；模型上下文另行校验。大模型窗口不取消请求体限制或更严格的浏览器边界。

已知 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 地址不缓存，因为内容可能变化。Pro/Pro 2 桥接支持 Chat Completions、Responses、Messages。浏览器四个附件的上限比 API 图像数量更严格。

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 指隐藏轨迹的低推理，不保证推理 token 为零或回答非空。大上下文也不等于同样长的输出。

个人密钥 RPM 和输出限制见账户与 /v1/balance。试用每分钟 10 次，同时一次；付费密钥没有统一承诺的 RPM。编辑器工具需要支持、配置和授权；单独设置 Base URL 不会授予本地文件、联网或执行命令的能力。

无订阅，余额不过期。付款、用量及访问问题请通过账户支持联系，人工审核，不承诺自动退款或固定回复期限。未公布独立的公开密码恢复渠道，也未实现自动找回。

客户端官方参考

以下链接介绍第三方工具配置，界面与功能可能随版本改变。客户端文档不会扩大 Dikaya 密钥权限。本页示例不会执行，复制也不会发送请求。本语言版实用文章有独立栏目。

文章