AZAPI 接口文档

一个 API 地址，搞定 220+ 大模型。兼容 OpenAI 格式，按量付费，额度永不过期。

REST OpenAI Compatible SSE 流式 220+ models

不用改代码，不用重构项目。把原来调用 OpenAI 的地址换掉，就能接着用——只不过模型选择从 GPT 变成了 GPT、Claude、Gemini、DeepSeek、通义千问……

Base URL
https://newapi.azapi.com.cn/v1

认证

每个请求需要在 Header 里带上你的 API Key。

Authorization: Bearer sk-your-api-key

Key 从哪儿来？登录控制台 → API 令牌 → 添加令牌 → 复制。建议给不同项目/设备分别建令牌，方便查用量。

别把 Key 写在公开仓库里。建议走服务端调用，前端/客户端用的话要做好代理。

聊天

POST /v1/chat/completions

最核心的接口，和 OpenAI 的格式一模一样。写代码的时候不需要任何额外的适配库。

主要参数

参数	说明
`model`	模型 ID，比如 `gpt-4o`、`claude-3-5-sonnet-20241022`、`deepseek-chat`
`messages`	对话数组，每条有 `role` 和 `content`
`stream`	是否流式，默认 false。设为 true 用 SSE 逐字返回
`temperature`	创造性程度，0~2，默认 1。越小越保守
`max_tokens`	最多生成多少个 token

来个最简单的请求

curl https://newapi.azapi.com.cn/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-xxxx" \ -d '{ "model": "gpt-4o", "messages": [{"role": "user", "content": "hi"}] }'

流式（SSE）

对话场景推荐开流式，用户体验好很多。stream: true 就行，返回格式也是标准 SSE。

curl ... -d '{ "model": "gpt-4o", "messages": [{"role": "user", "content": "hello"}], "stream": true }' # 返回的每一段： data: {"choices":[{"delta":{"content":"Hi"}}]} data: {"choices":[{"delta":{"content":" there"}}]} data: [DONE]

其他接口

文本嵌入

POST /v1/embeddings

把文字转成向量，做语义搜索、RAG 知识库的时候用。

curl https://newapi.azapi.com.cn/v1/embeddings \ -H "Authorization: Bearer sk-xxxx" \ -d '{"model": "text-embedding-3-small", "input": "hello world"}'

图像生成

POST /v1/images/generations

DALL-E 3、MJ 等。传 prompt 拿图片 URL。

curl https://newapi.azapi.com.cn/v1/images/generations \ -H "Authorization: Bearer sk-xxxx" \ -d '{"model": "dall-e-3", "prompt": "a cat", "size": "1024x1024"}'

语音转文字

POST /v1/audio/transcriptions

音频转文字，支持 mp3/wav/m4a。Whisper 系列模型。

curl https://newapi.azapi.com.cn/v1/audio/transcriptions \ -H "Authorization: Bearer sk-xxxx" \ -F file=@audio.mp3 \ -F model=whisper-1 \ -F language=zh

文字转语音

POST /v1/audio/speech

curl https://newapi.azapi.com.cn/v1/audio/speech \ -H "Authorization: Bearer sk-xxxx" \ -d '{"model": "tts-1", "input": "你好", "voice": "alloy"}' \ --output out.mp3

出错怎么办

状态码	通常意味着	怎么解决
`401`	Key 不对或过期了	检查 Authorization 头，去控制台确认 Key 有效
`403`	余额不够，或这个模型没授权	充值，或检查令牌的模型权限设置
`429`	太快了，或者上游满负载	降速重试，等几秒再试。一般自动恢复
`502/503`	这个模型暂时不可用	换个模型，或等几分钟等渠道自检恢复

429 最常见的几种情况：
• "上游模型负载已饱和" — 这模型用的人太多，等一会再试
• "暂无可用渠道" — 模型渠道故障自动关闭了，一般几分钟内自己恢复

几行代码接好

Python

# pip install openai from openai import OpenAI client = OpenAI(api_key="sk-xxxx", base_url="https://newapi.azapi.com.cn/v1") r = client.chat.completions.create( model="gpt-4o", messages=[{"role": "user", "content": "hi"}] ) print(r.choices[0].message.content)

Node.js

// npm install openai const { OpenAI } = require('openai'); const client = new OpenAI({ apiKey: 'sk-xxxx', baseURL: 'https://newapi.azapi.com.cn/v1' }); const r = await client.chat.completions.create({ model: 'gpt-4o', messages: [{ role: 'user', content: 'hi' }] }); console.log(r.choices[0].message.content);

直接 fetch

在各种工具里配置

通用信息：https://newapi.azapi.com.cn/v1 + 你的 API Key。下面是具体每个工具的配置位置。

Claude Code

Anthropic 的终端编程助手

装：npm install -g @anthropic-ai/claude-code

配环境变量（~/.bashrc 或 ~/.zshrc）：
export ANTHROPIC_BASE_URL=https://newapi.azapi.com.cn/v1
export ANTHROPIC_API_KEY=sk-xxxx

用：claude 启动，选 claude-opus-4-6

Cursor

AI 代码编辑器

打开设置：Cursor → Settings → Models

加自定义模型，填：
Provider: OpenAI / Anthropic
Base URL: https://newapi.azapi.com.cn/v1
Key: sk-xxxx
Model: gpt-4o 或 claude-3-5-sonnet-20241022

VSCode + Continue

开源 AI 编程插件

装插件：商店搜 "Continue" 安装

配 config.json（点齿轮图标）：

{ "models": [{ "title": "AZAPI", "provider": "openai", "model": "gpt-4o", "apiKey": "sk-xxxx", "apiBase": "https://newapi.azapi.com.cn/v1" }] }

快捷键：Ctrl+L 对话，Ctrl+Shift+L 补全

Cherry Studio

多模型桌面客户端（macOS/Windows/Linux）

设置 → 模型服务 → 添加 → 选 "OpenAI"

填：
API 地址：https://newapi.azapi.com.cn/v1
API 密钥：sk-xxxx

管理模型里添加 gpt-4o、claude-3-5-sonnet 等

NextChat (ChatGPT-Next-Web)

跨平台 ChatGPT 网页 UI

左下角 设置图标 → 接口地址填 https://newapi.azapi.com.cn/v1

API Key 填 sk-xxxx，模型下拉选或用自定义模型名

LobeChat

现代 AI 聊天框架，支持插件和 TTS

左下角头像 → 设置 → 语言模型 → OpenAI

打开"使用客户端请求"（Web 端则关）

填：API Key + 代理地址 https://newapi.azapi.com.cn/v1

点 获取模型列表，勾选要用的

Trae

字节跳动的 AI IDE

设置 → AI 模型 → 自定义模型

名称：AZAPI
Base URL：https://newapi.azapi.com.cn/v1
Key：sk-xxxx

选模型 gpt-4o 或 deepseek-chat，保存重启

Codex CLI

OpenAI 的终端 AI 工具

装：npm install -g @openai/codex（需 Node 22+）

配环境变量：

export OPENAI_BASE_URL=https://newapi.azapi.com.cn/v1 export OPENAI_API_KEY=sk-xxxx

用：codex

</>

Cline

VSCode AI 助手，支持文件编辑和终端

插件装好后点 Cline 面板 → 齿轮设置

API Provider 选 "OpenAI Compatible"

填：Base URL + Key + Model ID（如 gpt-4o）

aider

终端结对编程工具

装：pip install aider-chat

配：

export OPENAI_API_KEY=sk-xxxx export OPENAI_API_BASE=https://newapi.azapi.com.cn/v1

用：aider --model gpt-4o

译

沉浸式翻译

浏览器翻译插件

插件设置 → 翻译服务 → OpenAI

API Key + 自定义地址 https://newapi.azapi.com.cn/v1

模型推荐 gpt-4o-mini 或 gpt-3.5-turbo，翻译快且便宜

常见问题

Key 能在多个客户端同时用吗？

可以。不过建议给不同客户端分别建令牌，这样用量分开统计，也方便出问题的时候排查。

提示连接失败

先检查这几样：
1. 地址是不是写成了 https://newapi.azapi.com.cn/v1（末尾的 /v1 别忘了）
2. Key 是不是完整复制了（sk- 开头的一大串）
3. 账号还有没有余额
4. 这个令牌有没有开通你想用的模型

某个客户端找不到我想用的模型

不同客户端支持的模型不一样。Cursor 主要支持 OpenAI 和 Anthropic 的，Cherry Studio 和 LobeChat 支持的比较全。如果列表里没有，试试在"自定义模型名"里手动输入模型 ID（比如 deepseek-chat）。

流式输出不连贯/有卡顿

一般是网络问题。试试：
• 换个网络环境（公司/教育网可能有限制）
• 在客户端设置里把 timeout 调大一点
• 换个模型，有些模型的响应速度本身就更快