使用文档

欢迎使用 AI API 代理服务！本文档将帮助你快速集成和使用我们的服务。

🚀 快速开始

我们的 API 代理服务完全兼容原始 API，只需修改 baseURL 即可使用。

1. 测试服务状态

curl https://ai-api-proxy.2358314123.workers.dev/health

返回示例：

{
  "status": "ok",
  "timestamp": "2026-06-02T10:00:00.000Z",
  "version": "2.0.0-kiro",
  "supported": ["openai", "anthropic", "gemini", "kiro"]
}

🤖 OpenAI API

完全兼容 OpenAI 官方 API，支持所有 GPT 模型。

端点地址

https://ai-api-proxy.2358314123.workers.dev/v1/*

使用示例

curl https://ai-api-proxy.2358314123.workers.dev/v1/chat/completions \
  -H "Authorization: Bearer YOUR_OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-3.5-turbo",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

JavaScript 示例

import OpenAI from 'openai';

const openai = new OpenAI({
  apiKey: 'YOUR_OPENAI_API_KEY',
  baseURL: 'https://ai-api-proxy.2358314123.workers.dev/v1'
});

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

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

🧠 Anthropic (Claude) API

支持 Claude 全系列模型，包括 Claude 3。

端点地址

https://ai-api-proxy.2358314123.workers.dev/anthropic/*

使用示例

curl https://ai-api-proxy.2358314123.workers.dev/anthropic/v1/messages \
  -H "x-api-key: YOUR_ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3-haiku-20240307",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

Python 示例

from anthropic import Anthropic

client = Anthropic(
    api_key="YOUR_ANTHROPIC_API_KEY",
    base_url="https://ai-api-proxy.2358314123.workers.dev/anthropic"
)

message = client.messages.create(
    model="claude-3-haiku-20240307",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello!"}
    ]
)

print(message.content)

💎 Google Gemini API

支持 Gemini Pro 和 Gemini Pro Vision 模型。

端点地址

https://ai-api-proxy.2358314123.workers.dev/gemini/*

使用示例

curl "https://ai-api-proxy.2358314123.workers.dev/gemini/v1beta/models/gemini-pro:generateContent?key=YOUR_GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [{"text": "Hello!"}]
    }]
  }'

⚡ Kiro (Amazon Q) API

支持 Amazon Q 代码助手功能。

端点地址

https://ai-api-proxy.2358314123.workers.dev/kiro/api/v1/*

使用示例

curl https://ai-api-proxy.2358314123.workers.dev/kiro/api/v1/streaming-conversations \
  -H "Content-Type: application/json" \
  -d '{
    "conversationState": {
      "currentMessage": {
        "userInputMessage": {
          "content": "Write a hello world in Python"
        }
      },
      "chatTriggerType": "MANUAL"
    }
  }'

📝 代码示例

Node.js 完整示例

// 安装依赖：npm install openai anthropic

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

// OpenAI
const openai = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: 'https://ai-api-proxy.2358314123.workers.dev/v1'
});

// Anthropic
const anthropic = new Anthropic({
  apiKey: process.env.ANTHROPIC_API_KEY,
  baseURL: 'https://ai-api-proxy.2358314123.workers.dev/anthropic'
});

// 使用 OpenAI
async function testOpenAI() {
  const completion = await openai.chat.completions.create({
    model: 'gpt-3.5-turbo',
    messages: [{ role: 'user', content: 'Say hello!' }]
  });
  console.log(completion.choices[0].message.content);
}

// 使用 Anthropic
async function testAnthropic() {
  const message = await anthropic.messages.create({
    model: 'claude-3-haiku-20240307',
    max_tokens: 1024,
    messages: [{ role: 'user', content: 'Say hello!' }]
  });
  console.log(message.content[0].text);
}

testOpenAI();
testAnthropic();

Python 完整示例

# 安装依赖：pip install openai anthropic

from openai import OpenAI
from anthropic import Anthropic
import os

# OpenAI
openai_client = OpenAI(
    api_key=os.environ.get("OPENAI_API_KEY"),
    base_url="https://ai-api-proxy.2358314123.workers.dev/v1"
)

# Anthropic
anthropic_client = Anthropic(
    api_key=os.environ.get("ANTHROPIC_API_KEY"),
    base_url="https://ai-api-proxy.2358314123.workers.dev/anthropic"
)

# 使用 OpenAI
def test_openai():
    response = openai_client.chat.completions.create(
        model="gpt-3.5-turbo",
        messages=[{"role": "user", "content": "Say hello!"}]
    )
    print(response.choices[0].message.content)

# 使用 Anthropic
def test_anthropic():
    message = anthropic_client.messages.create(
        model="claude-3-haiku-20240307",
        max_tokens=1024,
        messages=[{"role": "user", "content": "Say hello!"}]
    )
    print(message.content[0].text)

test_openai()
test_anthropic()

❓ 常见问题

1. 服务是否免费？

是的，本服务完全免费。基于 Cloudflare Workers 免费计划，每天提供 10 万次免费请求。

2. 需要自己的 API Key 吗？

是的，你需要使用自己的 OpenAI、Anthropic 或 Gemini API Key。我们只是提供代理转发服务。

3. 支持流式响应吗？

是的，完全支持流式响应（SSE），与官方 API 行为一致。

4. 有速率限制吗？

Cloudflare Workers 免费计划限制为每天 10 万次请求。单个 IP 没有额外限制。

5. 如何添加 Kiro 账号？

请访问管理后台，在"添加 Kiro 账号"页面配置。详细步骤参考 GitHub 仓库的文档。

6. 数据安全吗？

我们不存储任何请求内容，所有数据都是透明转发到上游 API。你的 API Key 通过 HTTPS 加密传输。

7. 支持哪些模型？

• OpenAI: GPT-4, GPT-3.5-turbo, GPT-4-turbo 等所有模型
• Anthropic: Claude 3 系列（Opus, Sonnet, Haiku）
• Gemini: Gemini Pro, Gemini Pro Vision
• Kiro: Amazon Q Developer

8. 遇到问题怎么办？

请访问 GitHub Issues 提交问题，或查看项目文档。