API 文档

兼容 OpenAI / Anthropic / Google Gemini / OpenAI Responses 多种 API 格式

遇到问题?先来这里查答案

接入报错、返回异常、密钥无效……90% 的问题都能在本页找到答案。请先对照下方「错误码表」和「常见问题排查」,再决定是否求助他人。

反滥用声明

本平台免费资源,是给真正需要的人用的。拿公益去倒卖、去中转赚钱的,吃相难看,良心更难看。一经发现永久封号、永不申诉——不是我们狠,是你自己把自己的路走绝了。缺钱有手有脚,别把脸丢在公益地上。

Base URL(按协议选择)
协议Base URL / 端点说明
OpenAI / Responseshttps://api.ltzy.top/v1推荐使用,兼容最广
Anthropic(Claude)https://api.ltzy.topSDK 会自动拼接 /v1/messages
Google Geminihttps://api.ltzy.topSDK 会自动拼接 /v1beta/models/{model}:generateContent

统一网关域名 api.ltzy.top,仅路径前缀因协议而异。

认证方式

使用你的 API 密钥(sk- 开头),根据协议选择认证头:

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。创建成功后完整 Key 仅显示一次,请妥善保存。

快速开始(cURL 示例)
curl https://api.ltzy.top/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "build/deepseek-v4-flash-0731",
    "messages": [
      {"role": "user", "content": "你好,介绍一下你自己"}
    ],
    "stream": true
  }'

模型 ID 必须是真实存在的,可在「模型列表」页或 GET /v1/models 查看。

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="build/deepseek-v4-flash-0731",
    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: "build/deepseek-v4-flash-0731",
  messages: [{ role: "user", content: "你好" }],
  stream: true
});

for await (const chunk of response) {
  const content = chunk.choices[0]?.delta?.content || "";
  process.stdout.write(content);
}
热门模型
模型 ID厂商说明
加载中...

完整列表请到「模型列表」查看,或调用 GET /v1/models

API 端点(全部协议)
协议方法路径说明
OpenAIPOST/v1/chat/completions对话补全(流式+非流式)
GET/v1/models获取模型列表(免认证)
POST/v1/embeddings嵌入向量生成
POST/v1/responsesOpenAI Responses API 兼容
AnthropicPOST/v1/messagesClaude Messages API 兼容
GeminiPOST/v1beta/models/{model}:generateContentGoogle Gemini API 兼容

注意:旧版 /v1/completions 端点不受支持,请使用 /v1/chat/completions

多协议 SDK 使用示例
Anthropic SDK (Claude)
import anthropic

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

message = client.messages.create(
    model="build/deepseek-v4-flash-0731",
    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"}
)

model = genai.GenerativeModel("build/deepseek-v4-flash-0731")
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="build/gpt-oss-120b",
    input="你好,介绍一下你自己"
)
print(response.output_text)
错误码表(报错先对照这里)
状态码错误类型说明处理建议
200success请求成功-
400invalid_request请求参数错误 / body 为空检查 JSON、modelmessages 是否完整
401unauthorized认证失败:密钥缺失、无效、已停用或已删除检查认证头与 sk- 密钥是否正确
403forbidden无权限访问(账号被封禁或无可用密钥)检查账号状态,违规封禁请联系管理员
404not_found模型不存在或端点不存在到「模型列表」查真实 ID;确认路径未写错
429rate_limit请求频率超限或每日用量已达上限降低频率;到控制台「用量信息」查看上限
500server_error服务器内部错误稍后重试
502gateway_error上游服务不可用(上游维护中)稍后重试,关注维护公告
常见问题排查(FAQ)
1. 返回 401 / 「Invalid or missing API key」怎么办?
先确认密钥是否填写完整(sk- 开头);再确认认证头协议用对(OpenAI 用 Bearer,Anthropic 用 x-api-key,Gemini 用 x-goog-api-key)。最后到控制台「密钥管理」确认该密钥仍处于「启用」状态、未被删除。
2. 返回 404 / 模型不存在怎么办?
说明模型 ID 写错或已下线。到「模型列表」复制真实 ID,或用 GET /v1/models 拉取当前全部可用模型。已弃用模型会置灰标注「已弃用」,调用将报错。另外 /v1/completions 不支持,请用 /v1/chat/completions
3. 返回 429 / 请求太频繁怎么办?
触发了频率限制或达到了每日用量上限。到控制台「用量信息」查看「今日已用 / 每日上限」,降低请求频率、控制并发,或等待次日额度恢复。
4. 返回 502 / 网关错误怎么办?
通常是上游模型临时维护或不可用,与你的代码无关。稍后重试即可;若「官方自营」模型集体维护,页面会有维护公告,可先改用 build/... 等上游模型。
5. 开启了流式却没有输出?
确认请求体里 stream: true。服务端以 SSE 逐块返回 data: {...},内容在 choices[0].delta.content 中;注意流式请求不要用普通 JSON 解析,要用流式读取。
6. 该选哪个模型?
acu/auto-models 是自动路由,每次请求自动选择最快可用模型,适合追求速度;build/... 是 NVIDIA 上游大模型,能力更全面;acu/ 为官方自营。到「模型列表」可按「上下文 / 最大输出 / 能力」筛选。
7. 图像 / 视频 / 语音模型怎么调用?
图像生成如 zhipu/cogview-3-flash,视频如 zhipu/cogvideox-flash,语音/ASR 如 siliconflow/Qwen/Qwen3-ASR-1.7Bsiliconflow/FunAudioLLM/SenseVoiceSmall。此类模型输出为图像/视频,无 token 上限概念,请按对应协议调用。
8. 如何创建/重置 API 密钥?
登录后到控制台「密钥管理」创建密钥。创建成功后完整 Key 仅显示一次,请立即保存;若遗失可删除重建。密钥支持停用/启用,停用后接口立即返回 401。
还有问题?

先回到本页对照错误码表常见问题排查,大多数报错都能在这里找到答案。若仍未解决,欢迎到「QQ 群」或「社区」求助,记得带上报错的状态码与模型 ID。

— 赞助商 —
安逸云
安逸云
高性价比云服务器 · 特价9.9起
TokenLinks
TokenLinks
主流高性能模型,更快接入,更低成本。