海豚API 使用教程

快速开始

注册账号

1. 访问海豚API平台首页：https://api.haitun.tech/
2. 点击「注册」按钮。
3. 填写邮箱地址和密码。
4. 点击「获取验证码」，输入邮箱收到的验证码。
5. 点击「注册」完成账号创建。

登录系统

1. 在首页点击「登录」按钮。
2. 输入注册时使用的邮箱和密码。
3. 点击「登录」进入控制台。

创建 API Key

1. 在左侧菜单点击「API Keys」。
2. 点击「创建 API Key」按钮。
3. 输入一个便于识别的名称，例如「开发测试」。
4. 选择分组，如果有多个分组可选。
5. 点击「创建」。

查看可用模型和额度

创建 API Key 后，建议先进入「模型广场」或模型相关页面，查看当前分组可用模型、价格和上下文信息。需要购买订阅或充值余额时，可以进入「购买订阅」。如果已有卡密，可以进入「卡密兑换」。

第一次 API 调用

请将示例中的 YOUR_API_KEY 替换为您的实际 API Key。

Claude API

curl https://api.haitun.tech/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "你好，请介绍一下你自己"}
    ]
  }'

Python Claude SDK

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://api.haitun.tech"
)

message = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "你好，请介绍一下你自己"}
    ]
)

print(message.content[0].text)

OpenAI 兼容 API

海豚API提供 OpenAI 兼容接口，适合已经使用 OpenAI SDK 的项目。通常只需要修改 base_url 即可接入。

获取模型列表

curl https://api.haitun.tech/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Chat Completions

curl https://api.haitun.tech/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "messages": [
      {"role": "system", "content": "你是一个有帮助的助手。"},
      {"role": "user", "content": "什么是机器学习？"}
    ]
  }'

Python OpenAI SDK

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.haitun.tech/v1"
)

response = client.chat.completions.create(
    model="claude-sonnet-4-20250514",
    messages=[
        {"role": "user", "content": "你好，请介绍一下你自己"}
    ]
)

print(response.choices[0].message.content)

环境变量

export OPENAI_API_KEY=YOUR_API_KEY
export OPENAI_BASE_URL=https://api.haitun.tech/v1

Gemini API

海豚API支持 Gemini API 格式，可通过 Gemini SDK、Gemini CLI 或 HTTP 请求调用。

认证方式

x-goog-api-key: YOUR_API_KEY

curl 示例

curl "https://api.haitun.tech/v1beta/models/gemini-2.0-flash:generateContent?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [
          {"text": "用简单的语言解释量子计算"}
        ]
      }
    ]
  }'

Gemini CLI

npm install -g @google/gemini-cli

export GEMINI_API_KEY=YOUR_API_KEY
export GEMINI_API_BASE=https://api.haitun.tech

gemini "你好，请介绍一下你自己"

CLI 工具配置

Claude Code

npm install -g @anthropic-ai/claude-code

export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY
export ANTHROPIC_BASE_URL=https://api.haitun.tech

claude
claude .
claude "帮我重构这个函数"

OpenAI Codex CLI

npm install -g @openai/codex

export OPENAI_API_KEY=YOUR_API_KEY
export OPENAI_BASE_URL=https://api.haitun.tech/v1

codex
codex "创建一个 React 组件"

Codex config.toml

model = "claude-sonnet-4-20250514"
model_provider = "haitun"

[model_providers.haitun]
name = "海豚API"
base_url = "https://api.haitun.tech/v1"
env_key = "HAITUN_API_KEY"
wire_api = "chat"

export HAITUN_API_KEY=YOUR_API_KEY

IDE 配置

VS Code + Claude Code

{
  "claude-code.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.haitun.tech" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "YOUR_API_KEY" }
  ]
}

Cursor

API Key: YOUR_API_KEY
Base URL: https://api.haitun.tech/v1
Model: claude-sonnet-4-20250514

VS Code + Continue

{
  "models": [
    {
      "title": "Claude Sonnet 4",
      "provider": "anthropic",
      "model": "claude-sonnet-4-20250514",
      "apiKey": "YOUR_API_KEY",
      "apiBase": "https://api.haitun.tech"
    }
  ]
}

常见问题

API Key 创建后忘记保存怎么办？

API Key 创建时通常只显示一次。如果忘记保存，请删除旧 Key 并创建新的 Key。

API Key 泄露了怎么办？

请立即删除泄露的 Key，创建新的 Key，并更新所有使用旧 Key 的应用。

如何验证配置是否正确？

curl https://api.haitun.tech/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

为什么返回 401？

通常是 API Key 无效、没有传入 API Key，或请求头格式不正确。

为什么返回 402？

通常是余额不足或当前账户额度不足。请充值、购买订阅或联系管理员处理。

为什么返回 429？

请求过于频繁，触发并发或速率限制。请降低请求频率后重试。

为什么返回 529？

上游服务繁忙或过载。请稍后重试。

安全建议

1. 不要把 API Key 写入公开仓库。
2. 不要在前端网页中直接暴露 API Key。
3. 为不同项目创建不同 API Key，便于统计和管理。
4. 发现泄露后立即删除旧 Key 并创建新 Key。
5. 生产环境建议通过服务端转发请求，不建议让浏览器直接调用 API。