从零接入到排错,一站式开发指南
注册账号即可获得免费体验额度,无需绑定信用卡。
登录控制台 → 令牌管理 → 新建令牌,生成 sk- 开头密钥。令牌可设置额度上限、过期时间与可用模型范围,也可随时停用或删除。
将 base_url 改为下方接口地址,替换 API Key 即可调用全部模型,现有代码零改动。
接口地址(base_url):https://api.aigs.cc/v1
💡 免费模型 ox-alpha 不消耗余额,可无限调用,可先用它验证接入是否成功。
AIGS 完全兼容 OpenAI 接口,官方 SDK 开箱即用:安装 openai 库后,将 api_key 设为你的 AIGS 密钥、base_url 设为 https://api.aigs.cc/v1 即可。支持流式输出、Function Calling、Embeddings 与 Vision,调用方式与官方完全一致。
bashcurl https://api.aigs.cc/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-xxxxxxxx" \ -d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"你好"}],"stream":true}'
pythonfrom openai import OpenAI client = OpenAI(api_key="sk-xxxxxxxx", base_url="https://api.aigs.cc/v1") resp = client.chat.completions.create( model="deepseek-v4-flash", messages=[{"role": "user", "content": "你好,介绍一下你自己"}], stream=True, ) for chunk in resp: print(chunk.choices[0].delta.content or "", end
typescriptimport OpenAI from "openai"; const client = new OpenAI({ apiKey: "sk-xxxxxxxx", baseURL: "https://api.aigs.cc/v1", }); const stream = await client.chat.completions.create({ model: "deepseek-v4-flash", messages: [{ role: "user", content: "你好" }], stream: true, }); for chunk stream processstdoutchunkchoicesdeltacontent
提示:所有参数(model、messages、tools、max_tokens、temperature 等)与官方一致,无需任何适配层。
在应用的「模型设置 / OpenAI 兼容接口」中填入以下两项即可,非 OpenAI 原生接口的应用也可通过其反向代理能力接入:
https://api.aigs.cc/v1(部分应用填 https://api.aigs.cc)sk- 密钥已验证适配:Dify、FastGPT、LobeChat、Cherry Studio、ChatBox、Cursor、Cline、沉浸式翻译等。
按 token 用量逐笔扣费,最小精确到微元(¥0.000001),每笔消耗明细在控制台实时可查。
充值余额长期有效、永不过期,随充随用,无最低消费,用多少扣多少。
对外售价 = 官方牌价 × 1.15,公开可对比。具体价格以控制台「模型广场」实时显示为准。
免费模型 ox-alpha 不消耗余额,无需付费即可调用,适合调试与低成本场景。
会员分组享受模型折扣倍率,充值金额与账户余额在控制台「充值中心」管理。
| 错误码 | 含义 | 处理建议 |
|---|---|---|
401 UNAUTHORIZED | 令牌无效或已过期 | 检查 Key 是否正确、是否被删除、停用或过期 |
402 INSUFFICIENT_QUOTA | 余额不足 | 前往控制台充值或调整令牌额度上限 |
400 INVALID_INPUT | 请求参数不符合要求 | 核对 model 名称与 messages 格式 |
404 MODEL_NOT_FOUND | 模型不存在或已下架 | 确认模型名正确,未被下架;查看模型广场可用清单 |
429 RATE_LIMITED | 触发限流 | 降低请求频率,或提升账户分组/会员等级 |
503 MODEL_UNAVAILABLE | 上游暂不可用 | 稍后重试,系统会自动切换备用渠道 |