API 文档

快速开始

一分钟内完成接入。AI Duet 可直接替换 Anthropic 和 OpenAI API。

API 端点

https://api.aiduet.app

认证方式

在请求头中携带你的 API Key：

# Anthropic format
x-api-key: hr-your-api-key-here

# OpenAI format
Authorization: Bearer hr-your-api-key-here

支持的格式

AI Duet 同时接受 Anthropic Messages API 和 OpenAI Chat Completions API 格式。

A Anthropic Messages API

curl https://api.aiduet.app/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: hr-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 4096,
    "messages": [
      {"role": "user", "content": "Write a Python function to sort a list"}
    ]
  }'

O OpenAI Chat API

curl https://api.aiduet.app/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer hr-your-api-key" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "user", "content": "Write a Python function to sort a list"}
    ]
  }'

模型编排

无需指定模型。AI Duet 自动路由：Opus 4.6 负责规划和审查，GPT-5.4 负责代码生成。发送请求即可，编排过程完全透明。

Opus 4.6

Planning, code review, orchestration

GPT-5.4

Code generation, fast execution

工具集成

OpenClaw

# In OpenClaw config
api_base: https://api.aiduet.app
api_key: hr-your-api-key

Cursor

# Cursor Settings → Models → OpenAI API Base
https://api.aiduet.app/v1

任何 OpenAI 兼容工具

OPENAI_API_BASE=https://api.aiduet.app/v1
OPENAI_API_KEY=hr-your-api-key

错误码

Code	Description
401	无效或缺失 API Key
402	余额不足
429	请求频率超限
500	服务器内部错误