API 文档 - AQUA 公益AI

Base URL

https://api.ltzy.top/v1

所有 API 请求均需在路径前加上 /v1（Gemini 协议使用 /v1beta）

认证方式

支持多种认证方式，根据协议选择：

1. OpenAI / Responses 协议

Authorization: Bearer sk-your-api-key

2. Anthropic 协议

x-api-key: sk-your-api-key

3. Google Gemini 协议

x-goog-api-key: sk-your-api-key

在控制台「密钥管理」页面创建密钥获取 API Key

cURL 示例

curl https://api.ltzy.top/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/deepseek-v4-flash",
    "messages": [
      {"role": "user", "content": "你好，介绍一下你自己"}
    ],
    "stream": true
  }'

Python SDK 示例

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.ltzy.top/v1"
)

response = client.chat.completions.create(
    model="deepseek-ai/deepseek-v4-flash",
    messages=[
        {"role": "user", "content": "你好"}
    ],
    stream=True
)

for chunk in response:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Node.js SDK 示例

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-your-api-key",
  baseURL: "https://api.ltzy.top/v1"
});

const response = await client.chat.completions.create({
  model: "deepseek-ai/deepseek-v4-flash",
  messages: [{ role: "user", content: "你好" }],
  stream: true
});

for await (const chunk of response) {
  const content = chunk.choices[0]?.delta?.content || "";
  process.stdout.write(content);
}

热门模型

模型 ID	厂商	说明
加载中...

错误码表

状态码	错误类型	说明
200	success	请求成功
400	invalid_request	请求参数错误
401	auth_failed	认证失败，密钥无效或未登录
403	forbidden	无权限访问（账号被封禁或无可用密钥）
404	not_found	资源不存在
429	rate_limit	请求频率超限或每日用量已达上限
500	server_error	服务器内部错误
502	gateway_error	网关错误，上游服务不可用

API 端点（全部协议）

协议	方法	路径	说明
OpenAI	POST	/v1/chat/completions	对话补全（流式+非流式）
	GET	/v1/models	获取模型列表
	POST	/v1/embeddings	嵌入向量生成
Anthropic	POST	/v1/messages	Claude Messages API 兼容
Responses	POST	/v1/responses	OpenAI Responses API 兼容
Gemini	POST	/v1beta/models/{model}:generateContent	Google Gemini API 兼容

多协议 SDK 使用示例

Anthropic SDK (Claude)

import anthropic

client = anthropic.Anthropic(
    api_key="sk-your-api-key",
    base_url="https://api.ltzy.top/v1"
)

message = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}]
)
print(message.content[0].text)

Google Gemini SDK

import google.generativeai as genai

genai.configure(
    api_key="sk-your-api-key",
    client_options={"api_endpoint": "api.ltzy.top/v1beta"}
)

model = genai.GenerativeModel("gemini-2.0-flash")
response = model.generate_content("你好")
print(response.text)

OpenAI Responses API

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.ltzy.top/v1"
)

response = client.responses.create(
    model="gpt-5-codex",
    input="你好，介绍一下你自己"
)
print(response.output_text)