01 · 开始使用
注册、登录与余额
欢迎使用 dim10。先注册账号;已有账号可登录后返回文档。进入控制台检查余额,再按需前往充值购买,首次先用小请求测试。
02 · 安全凭证
创建并保管 API Key
在密钥管理创建密钥,核对分组、权限及页面提供的额度设置。密钥相当于调用凭证,不要放进网页前端、截图或 Git 仓库;泄露后立即撤销并更换。
以下示例中的 YOUR_API_KEY 必须替换为自己的密钥。建议通过环境变量注入;不要分享包含凭证的终端记录。
export DIM10_API_KEY="YOUR_API_KEY"
03 · 验证连接
先查模型,再发请求
OpenAI 兼容客户端的 Base URL 填 https://api.dim10.com/v1。先查询当前密钥可见模型;MODEL_ID 是占位符,不可原样调用。
curl --fail-with-body https://api.dim10.com/v1/models \
-H "Authorization: Bearer $DIM10_API_KEY"
仅当分组和模型支持 Chat Completions 时使用下例;模型可见不代表支持所有接口。不要重复拼接 /v1。
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/config.toml,合并以下配置,替换模型 ID,勿重复声明已有表。先设置上文环境变量,再从同一终端运行 codex。
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
/v1。按官方指南安装。以下采用网关 Bearer 鉴权;确认分组接受该方式后,在独立终端先设置上文的 DIM10_API_KEY,再执行下例,避免混用其他服务的凭证。
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 和脱敏错误信息,不提供完整密钥或敏感对话。