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:
不要把 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。
下一步