API 调用方法

DAMI TOKEN 提供统一 API 入口,用户通过平台 API Key 调用已授权模型。本文展示常见调用方式,实际域名、路径和模型名称以你的站点配置为准。

API 端点

平台通常会提供一个兼容接口地址,作为客户端的 Base URL。

主要端点

常见端点包括:

端点 用途
/v1/models 获取当前 Key 可访问的模型列表
/v1/chat/completions OpenAI 兼容聊天补全接口
/v1/responses OpenAI Responses 风格接口
/v1/messages Anthropic Messages 风格接口

如果你的部署路径不同,请以控制台显示为准。

认证

所有请求都应携带用户 API Key:

Authorization: Bearer YOUR_API_KEY

不要把 API Key 写入公开仓库、前端页面或共享截图。如果密钥泄露,请立即删除并重新创建。

填入你的 API Key

推荐使用环境变量保存密钥:

export DAMI_API_BASE_URL="https://damiai.pro/v1"
export DAMI_API_KEY="sk-your-key"

Windows PowerShell 可以使用:

$env:DAMI_API_BASE_URL="https://damiai.pro/v1"
$env:DAMI_API_KEY="sk-your-key"

请求示例

以下示例仅展示调用结构。请替换模型名称、Base URL 和 API Key。

Responses(GPT)

curl "$DAMI_API_BASE_URL/responses" \
  -H "Authorization: Bearer $DAMI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "用一句话介绍 DAMI TOKEN"
  }'

流式响应(GPT)

curl "$DAMI_API_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $DAMI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "stream": true,
    "messages": [
      {"role": "user", "content": "写一个简短的接口测试计划"}
    ]
  }'

Claude(Anthropic 格式)

curl "$DAMI_API_BASE_URL/messages" \
  -H "Authorization: Bearer $DAMI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 512,
    "messages": [
      {"role": "user", "content": "解释什么是 API 网关"}
    ]
  }'

使用 SDK

大多数 SDK 都支持自定义 Base URL。你只需要把默认上游地址替换为 DAMI TOKEN 地址。

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-key",
    base_url="https://damiai.pro/v1",
)

response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "Hello"}],
)

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

Node.js (OpenAI SDK)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.DAMI_API_KEY,
  baseURL: process.env.DAMI_API_BASE_URL,
});

const response = await client.chat.completions.create({
  model: 'gpt-5.5',
  messages: [{ role: 'user', content: 'Hello' }],
});

console.log(response.choices[0]?.message?.content);

Anthropic SDK

如果客户端或 SDK 支持自定义 Anthropic API 地址,可以将 Base URL 指向平台兼容端点,并使用 DAMI TOKEN API Key 认证。

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  apiKey: process.env.DAMI_API_KEY,
  baseURL: process.env.DAMI_API_BASE_URL,
});

const message = await client.messages.create({
  model: 'claude-sonnet-4-6',
  max_tokens: 512,
  messages: [{ role: 'user', content: 'Hello' }],
});

console.log(message.content);

速率限制

平台可能从多个维度限制请求:

  • 用户级 RPM。
  • 用户余额。
  • API Key 状态。
  • 分组权限。
  • 上游账号并发。
  • 模型或通道可用性。

遇到限制时,请降低并发、检查余额,或联系管理员调整策略。

最佳实践

  • 为不同应用创建不同 API Key。
  • 在服务端保存密钥,避免暴露到浏览器。
  • 调试时使用短请求和低成本模型。
  • 生产任务开启日志和余额预警。
  • 定期轮换长期使用的 API Key。

下一步