QUICK START

快速开始

AI API WAY 完全兼容 OpenAI 接口规范:把 base_url 换成 https://gw.aiapiway.com/v1,其余代码不变。

接入三要素(缺一不可)

① 调用链接https://gw.aiapiway.com/v1② API 密钥控制台「API 密钥」页创建后复制(sk- 开头)③ 模型名称必须与下方明细一字不差(如 claude-fable-5); 名称错误会返回「无可用渠道」。也可调用 GET /v1/models 实时获取你的密钥可用列表。

Claude 蒸馏密钥

蒸馏已拆为两组:claude-distill-v1(控制台「Claude · 蒸馏 v1」)与 claude-distill-v2(「Claude · 蒸馏 v2」)。请使用 POST /v1/chat/completions做批量/高并发蒸馏;请勿使用 /v1/responses。旧组 claude-distill仅存量兼容,新建请选 v1/v2。满血 Claude 请用「Claude · 标准」。

  1. 1
    注册并获取密钥

    注册 AI API WAY 账户后,在控制台「API 密钥」页创建一把 sk- 密钥(可随时回查与复制)。

  2. 2
    充值额度

    在「充值」页选择套餐,支付成功后额度自动到账(按 1 USD = 平台额度换算,余额实时可查)。

  3. 3
    替换 base_url 并使用精确模型名

    把现有代码里 OpenAI SDK 的 base_url 换成 AI API WAY 网关地址;模型名从下方「模型名称明细」或密钥页复制,须一字不差。

代码示例

正式接入推荐 Python 或 Node.js(跨 Windows / macOS 一致,少踩终端语法坑)。 curl 仅适合快速试连:macOS/Linux 用「curl」页;Windows 命令提示符(cmd)请改用「curl (Windows)」页——不要把带行尾 \ 的多行示例粘进 cmd。

from openai import OpenAI

client = OpenAI(
    base_url="https://gw.aiapiway.com/v1",  # 只改这一行
    api_key="sk-aiapiway-****",
)
resp = client.chat.completions.create(
    model="claude-fable-5",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

模型名称明细(按密钥分组)

每把密钥绑定一个分组,只能调用该分组内的模型;下表与线上实时同步,调用时模型名须与此处完全一致。价格见 模型与价格。

Claude · 稳定标准版claude-std12 款
claude-fable-5claude-fable-5-1claude-haiku-4-5claude-haiku-4-5-20251001claude-opus-4-6claude-opus-4-7claude-opus-4-8claude-opus-5claude-opus-5-5claude-sonnet-4-6claude-sonnet-5claude-sonnet-5-5
Claude · Max 满血版claude-max13 款
claude-fable-5claude-fable-5-1claude-haiku-4-5claude-haiku-4-5-20251001claude-haiku-5-5claude-opus-4-6claude-opus-4-7claude-opus-4-8claude-opus-5claude-opus-5-5claude-sonnet-4-6claude-sonnet-5claude-sonnet-5-5
Claude · 蒸馏线路 v1claude-distill-ccmax9 款
claude-fable-5claude-fable-5-1claude-opus-4-6claude-opus-4-7claude-opus-4-8claude-opus-5claude-opus-5-5claude-sonnet-4-6claude-sonnet-5
GPT · 极速标准版gpt-std11 款
gpt-5.6-lunagpt-5.6-solgpt-5.6-terragpt-6gpt-6-astragpt-6-lunagpt-6-solgpt-6.1-solgpt-6.1-terragpt-6.2-astragpt-6.2-sol
GPT · 稳定企业版gpt-pro11 款
gpt-5.6-lunagpt-5.6-solgpt-5.6-terragpt-6gpt-6-astragpt-6-lunagpt-6-solgpt-6.1-solgpt-6.1-terragpt-6.2-astragpt-6.2-sol
Gemini · 特惠标准版gemini-std6 款
gemini-3.6-flashgemini-3.7-flashgemini-3.8-flashgemini-4-argongemini-4-carbongemini-4-hydrogen
Gemini · 企业稳定版gemini-pro7 款
gemini-3.5-flashgemini-3.6-flashgemini-3.7-flashgemini-3.8-flashgemini-4-argongemini-4-carbongemini-4-hydrogen
生图 · 标准image-std7 款
gpt-image-2gpt-image-2.5gpt-image-2.5-flaregpt-image-2.5-sunburstgpt-image-2.6gpt-image-2.6-flaregpt-image-2.6-sunburst
生图 · 极速image-fast8 款
gemini-nano-banana-2.1gpt-image-2gpt-image-2.5gpt-image-2.5-flaregpt-image-2.5-sunburstgpt-image-2.6gpt-image-2.6-flaregpt-image-2.6-sunburst
视频 · Seedance 2.5video-std3 款
doubao-seedance-2-5doubao-seedance-2-5-260628doubao-seedance-2-5-260628-max
视频 · Seedance 2.0video-std-seedance206 款
doubao-seedance-2-0-260128doubao-seedance-2-0-260128-maxdoubao-seedance-2-0-fast-260128doubao-seedance-2-0-fast-260128-maxdoubao-seedance-2-0-mini-260615doubao-seedance-2-0-mini-260615-max
视频 · Seedance 海外版video-seedance-hc2 款
dreamina-seedance-2-0-hcdreamina-seedance-2-5-hc
GLM · GLM 5.3glm-std2 款
glm-5.3glm-5.3-flash
GLM · GLM 5.2glm-std-521 款
glm-5.2
DeepSeek · 全系列deepseek-std6 款
deepseek-v4-flashdeepseek-v4-flash-ga-260731deepseek-v4-prodeepseek-v4-pro-0813deepseek-v4.1-flashdeepseek-v4.1-flash-1017
Grok · 标准grok-std2 款
grok-4.5grok-4.6
Kimi · Kimi K3kimi-std2 款
kimi-k3kimi-k3.1-pro
gpt-openaigpt-openai7 款
gpt-6-astragpt-6-lunagpt-6-solgpt-6.1-solgpt-6.1-terragpt-6.2-astragpt-6.2-sol
gpt-azuregpt-azure7 款
gpt-6-astragpt-6-lunagpt-6-solgpt-6.1-solgpt-6.1-terragpt-6.2-astragpt-6.2-sol
claude-anthropicclaude-anthropic10 款
claude-fable-5claude-fable-5-1claude-opus-4-6claude-opus-4-7claude-opus-4-8claude-opus-5claude-opus-5-5claude-sonnet-4-6claude-sonnet-5claude-sonnet-5-5
claude-zackzhang405claude-zackzhang40512 款
claude-fable-5claude-fable-5-1claude-haiku-4-5claude-haiku-4-5-20251001claude-opus-4-6claude-opus-4-7claude-opus-4-8claude-opus-5claude-opus-5-5claude-sonnet-4-6claude-sonnet-5claude-sonnet-5-5
kimi-zhuanshukimi-zhuanshu1 款
kimi-k3
claude-aswbclaude-aswb4 款
claude-haiku-4-5claude-opus-4-6claude-sonnet-4-5claude-sonnet-4-6
video-wan3video-wan32 款
wan3.0-videowan3.0-video-prime
qwenqwen1 款
qwen3.8-flash

API 参考

POST/v1/chat/completions对话补全(支持 stream 流式)
POST/v1/responses会话续存对话(历史托管平台,断线/换渠道记忆不丢)
GET/v1/responses/{id}凭 id 读回某轮结果(断线补偿)
POST/v1/images/generations文生图(gpt-image-2 / 2.5-flare / 2.5-sunburst)
POST/v1/images/edits图生图 / 改图(multipart 传原图,详见「图像生成」章)
POST/v1/video/generations视频生成(Seedance / 万相 3.0 同一接口;异步任务:提交后凭 task_id 查询结果,详见「视频生成」章)
GET/v1/video/generations/{task_id}查询视频生成任务结果
POST/v1/audio/speech语音合成(TTS 类模型)
POST/v1/embeddings文本向量
GET/v1/models当前密钥可用的模型列表

鉴权方式:请求头 Authorization: Bearer sk-****(同一把密钥通用于以上全部接口)。接口跟着模型类型走:对话模型用 chat/completions;生图(gpt-image-2 / 2.5-flare / sunburst)、视频(如 seedance 系列)、语音模型须调用各自接口, 用错接口会返回「无可用渠道」。生图(含图生图改图)见 图像生成章;视频为异步任务,参数与素材传法见 视频生成章;多轮对话 / Agent 想把输入费砍到 1/10,见 提示缓存省钱指南;Claude 长会话的上限、超限错误与压缩方法见 超长上下文接入须知;代理商想用程序管理自己的客户(建号 / 代管密钥 / 查用量 / 划拨),见 代理商开放接口;模型名与价格见 模型与价格;实时可用性见 状态与评测。

常见问题

与直接调用官方 API 有什么区别?›

接口协议完全一致。区别在于:一个密钥可调多家模型;多上游自动容灾;对话价对标官方短上下文刊例,生图为平台按次价(详见图像生成章);支持人民币/对公与发票。

多轮对话断线后,AI 会忘掉之前聊的吗?›

不会——用 /v1/responses 会话续存接口,对话历史存在平台侧,上游断线、账号轮转、切换渠道都不影响记忆;断线重发同一请求 10 分钟内自动幂等,不重复计费。详见「对话连续性」章。

多轮对话 / Agent 的输入费怎么降?›

用提示缓存:读缓存按 0.1× 计费。前缀顺序固定、在 tools 末项 / system 末块 / 最后一条消息打 cache_control、给会话一个稳定的 metadata.user_id,第二轮起读占比可到 90% 以上(我们实测 94.1%)。OpenAI 格式调 Claude 同样支持。写法与代码见「提示缓存省钱指南」章。

如何证明没有"降智"?›

我们每 6 小时对全部在售模型运行金丝雀评测(算术、代码断言、格式遵循、长上下文针刺等),与官方基准逐项比对,报告公开可查、历史可回溯。

支持哪些计费方式?›

按量计费(tokens),额度预充值。企业客户支持合同、对公转账与发票,详见代理合作页或联系 [email protected]。

Windows 上 curl 报 Bad hostname /「不是内部或外部命令」?›

多半是把 macOS/Linux 的多行 curl(行尾反斜杠)粘进了命令提示符(cmd)。请改用本页「curl (Windows)」一行示例,或直接用 Python/Node 示例(推荐)。