跳到主要内容

快速开始

本页帮助你完成鼎惠API 的基础接入流程。新用户建议先跑通一个最小请求，再接入具体工具或业务代码。

1. 登录控制台​

打开 鼎惠API 控制台。如果还没有账号，先完成注册和登录。

登录后建议先检查三项内容：

项目说明
账户状态确认账号可用，未被风控或停用
余额 / 套餐确认可用额度足够完成测试
请求日志后续排查时用于确认请求是否到达平台

2. 创建 API Key​

进入 API Key 管理页面，新建一个 Key。建议按用途命名，例如：

  • local-dev
  • codex-cli
  • cline-vscode
  • production-app

不要把同一个 Key 同时用于本地测试、生产服务和多个第三方工具。分开创建 Key 后，后续可以按项目统计用量，也可以单独停用异常 Key。

3. 查看模型 ID​

打开 模型广场，确认要调用的模型 ID。注意区分模型展示名和模型 ID，实际请求必须填写模型 ID。

常见模型类型：

类型适合场景
Claude 系列长上下文、代码理解、复杂推理
GPT 系列通用问答、工具调用、结构化输出
Gemini 系列多模态、长文本、图像相关能力
Kimi / DeepSeek / GLM中文场景、代码辅助、性价比任务

实际可用模型和价格以模型广场显示为准。

4. 选择接入协议​

不同工具使用的协议不同：

协议常见路径常见工具
OpenAI Chat Completions/v1/chat/completionsCherry Studio、Chatbox、Cline、OpenCode
OpenAI Responses/v1/responsesCodex、部分新工具
Anthropic Messages/v1/messagesClaude Code、Claude 兼容客户端
Gemini Native/v1beta/models/{model}:generateContentGemini CLI、Gemini SDK

如果不确定工具使用什么协议，先查看对应工具配置页。

5. 发起第一个请求​

OpenAI 兼容示例：

curl https://www.tophdd.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-your-dinghui-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "messages": [
      {"role": "user", "content": "请用一句话介绍鼎惠API"}
    ]
  }'

Anthropic 兼容示例：

curl https://www.tophdd.cn/v1/messages \
  -H "x-api-key: sk-your-dinghui-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-claude-model-id",
    "max_tokens": 512,
    "messages": [
      {"role": "user", "content": "请用一句话介绍鼎惠API"}
    ]
  }'

6. 查看请求日志​

请求完成后回到控制台查看日志。重点检查：

  • 请求是否到达平台
  • 使用的模型 ID 是否正确
  • 输入和输出 Token 是否符合预期
  • 是否发生重试、超时或错误

7. 接入工具​

完成最小请求后，可以按工具类型继续配置：