大航海API
DEVELOPER DOCS

API 接入文档

一个 Base URL、一把 API 密钥,连接 Claude、OpenAI 与 Gemini 常用协议。

01 · 快速开始

三步完成首次调用

  1. 注册账户

    完成邮箱注册并登录控制台。

  2. 创建 API 密钥

    在控制台创建以 sk- 开头的密钥。

  3. 选择协议调用

    将 SDK 的 Base URL 修改为本站 API 地址。

02 · 认证方式

使用 Bearer Token

在请求头中携带 API 密钥。请勿把密钥写入浏览器前端代码或公开仓库。

Authorization: Bearer sk-your-api-key
Content-Type: application/json
03 · 接口列表

常用端点

POST/v1/messages
Claude Messages

Claude 原生 Messages API,适用于 Claude SDK 与 Claude Code。

POST/v1/responses
OpenAI Responses

OpenAI Responses API,适用于 Codex 与新一代 Agent 工作流。

POST/v1/chat/completions
Chat Completions

OpenAI Chat Completions 兼容接口。

GET/v1/models
获取模型

返回当前密钥所属分组可用的模型列表。

POST/v1beta/models/{model}:generateContent
Gemini 原生

Gemini SDK 与 Gemini CLI 原生格式。

04 · 请求示例

Claude Messages

curl https://api.dhhapi.com/v1/messages \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "你好,请介绍一下自己"}
    ]
  }'

OpenAI Chat Completions

curl https://api.dhhapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [{"role": "user", "content": "Hello"}]
  }'
05 · 常见错误

排查指南

401密钥无效

确认 Bearer Token 完整且未被禁用。

402余额不足

检查账户余额或套餐额度。

429请求过快

降低并发并采用指数退避重试。

5xx服务异常

稍后重试;持续出现时联系微信 Dhh1402。