跳转到文档内容
dim10 Developer Docs

文档中心从这里,开始第一次调用。

从注册、创建 API Key,到应用接入与费用查询。
保留你熟悉的工具,跟着步骤完成配置。

01 · 开始使用

注册、登录与余额

欢迎使用 dim10。先注册账号;已有账号可登录后返回文档。进入控制台检查余额,再按需前往充值购买,首次先用小请求测试。

付款后以平台到账记录为准;未到账时保留订单号,勿反复付款。

02 · 安全凭证

创建并保管 API Key

在密钥管理创建密钥,核对分组、权限及页面提供的额度设置。密钥相当于调用凭证,不要放进网页前端、截图或 Git 仓库;泄露后立即撤销并更换。

以下示例中的 YOUR_API_KEY 必须替换为自己的密钥。建议通过环境变量注入;不要分享包含凭证的终端记录。

Shell
export DIM10_API_KEY="YOUR_API_KEY"

03 · 验证连接

先查模型,再发请求

OpenAI 兼容客户端的 Base URL 填 https://api.dim10.com/v1。先查询当前密钥可见模型;MODEL_ID 是占位符,不可原样调用。

Shell · 模型列表
curl --fail-with-body https://api.dim10.com/v1/models \
  -H "Authorization: Bearer $DIM10_API_KEY"

仅当分组和模型支持 Chat Completions 时使用下例;模型可见不代表支持所有接口。不要重复拼接 /v1。

Shell · 对话请求
curl --fail-with-body https://api.dim10.com/v1/chat/completions \
  -H "Authorization: Bearer $DIM10_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"MODEL_ID","messages":[{"role":"user","content":"你好"}]}'

04 · 编程工具

连接 Codex CLI

前提:当前分组与所选模型支持 Codex 所需的 Responses API 及工具调用。Chat Completions 测试成功并不能证明 Codex 可用。

按官方安装指南安装;备份 ~/.codex/config.toml,合并以下配置,替换模型 ID,勿重复声明已有表。先设置上文环境变量,再从同一终端运行 codex。

TOML · ~/.codex/config.toml
model = "MODEL_ID"
model_provider = "dim10"

[model_providers.dim10]
name = "dim10"
base_url = "https://api.dim10.com/v1"
env_key = "DIM10_API_KEY"
wire_api = "responses"

字段依据:Codex 官方自定义提供商配置。先在测试目录验证,不要直接授权修改生产项目。

05 · 编程工具

连接 Claude Code

仅适用于已开放 Anthropic Messages 协议、相应鉴权与工具调用能力的分组。这里填站点根地址,不加 /v1。

按官方指南安装。以下采用网关 Bearer 鉴权;确认分组接受该方式后,在独立终端先设置上文的 DIM10_API_KEY,再执行下例,避免混用其他服务的凭证。

Shell
export ANTHROPIC_BASE_URL="https://api.dim10.com"
export ANTHROPIC_AUTH_TOKEN="$DIM10_API_KEY"
export ANTHROPIC_MODEL="MODEL_ID"
claude

替换为分组实际允许的 Claude 模型 ID;用 /status 核对地址与凭证来源。若辅助模型调用被拒绝,核对模型映射,不要反复重试。参考官方网关配置及模型配置。

06 · 选择模型

以实际可见模型为准

打开模型广场,选择实际展示的模型,复制准确 ID,并核对分组权限、协议与计费项;再用当前密钥查询确认。列表会调整,本文不保证任何指定模型始终可用。

查看模型与当前费率 →

07 · 核对费用

充值与用量记录

在购买页面核对金额和规则,在用量记录检查调用与扣费。不同模型、分组及计费项可能不同;以平台显示的费率和实际账单为准,不按示例推算固定折扣。

08 · 常见问题

请求失败怎么排查?

现象优先检查
401 / 403密钥是否有效、鉴权方式与分组权限是否匹配。
404 / 模型不可用地址、模型 ID、接口协议;确认没有重复 /v1。
429 / 额度提示查看错误正文、余额及限流提示;降低并发,勿无限重试。
超时 / 5xx检查网络并稍后重试;先查用量记录,避免重复调用。

以上仅为排查方向,以错误正文为准。反馈时提供时间、模型 ID、请求 ID 和脱敏错误信息,不提供完整密钥或敏感对话。

配置完成,开始创造。管理 API Key →