小白也能跟着做 · 5 分钟跑通

国产大模型 API 接入教程

5 分钟跑通妙信 AI:注册领试用金 → 充值 → 创建 API Key → 在 cc-switch / DeepSeek Harness / ChatBox 里发出一条请求。

第 1 步:注册,领试用金

  1. 点击页面上的「立即试用」,打开 妙信 AImoxt 注册页,用邮箱/手机号注册并登录。
  2. 登录后看「活动」或「钱包」页面,领取新用户试用余额;没有看到入口就点右下角在线客服。
  3. 这笔钱足够跑通几十到几百次小请求,先别急着充值。

说明:试用余额与领取方式以活动页/控制台为准;同一用户/同一设备通常只能领一次。

第 2 步:充值(试用金用完后)

  1. 左侧菜单进入「钱包」→「充值」。
  2. 选择金额(建议先充 10–50 元测试),选择页面显示的支付方式完成支付。
  3. 到账后在「钱包」能看到余额;按量扣费,不需要买月套餐。

需要开票/对公转账:先在在线客服说明公司名称、税号、金额,按客服给的流程走。

第 3 步:创建 API Key

  1. 左侧菜单进入「API 密钥」→ 点「创建密钥」。
  2. 名称随便填(例如 `my-test`);分组按用途选:
    • 国产-经济:0.2x,日常对话/客服/写作,最便宜。
    • 国产-稳定:0.5x,长上下文/稳定输出,部分 GLM/Kimi 模型。
    • 国产-旗舰:0.8x,Qwen3.8-Max 等旗舰模型。
  3. 额度可以先选「无限」或填一个小额度;过期时间选「永不过期」方便测试。
  4. 保存后复制 `sk-` 开头的完整 Key。只保存在自己电脑/密码管理器里,不要发群里。

第 4 步:记住这 3 个参数

Base URL
https://www.aimoxt.com/v1
API Key
你刚创建的 sk-...(不要泄露)
模型名
deepseek-v4.1-flash / glm-5.3 / kimi-k3 / qwen3.8-max 等

模型名必须和价格表/控制台完全一致;不要填“DeepSeek”这种显示名。分组里没有的模型会返回 404。

第 5 步:导入客户端

A. cc-switch(推荐给编程类客户端)

  1. 打开 cc-switch,点「添加供应商」或「自定义 / 添加配置」。
  2. 类型选「OpenAI 兼容」或「自定义 API」。
  3. 名称填 `妙信 AImoxt`;Base URL 填 `https://www.aimoxt.com/v1`;API Key 填 `sk-...`。
  4. 模型填 `deepseek-v4.1-flash`(或你要用的模型),保存并切换到 妙信 AImoxt。
  5. 如果 cc-switch 版本要求填完整 URL,可用 `https://www.aimoxt.com/v1/chat/completions`;以当前版本提示为准。

B. DeepSeek Harness / 其他 OpenAI 兼容 CLI

在设置页或配置文件里填三项;如果工具用环境变量,则设置:

export OPENAI_BASE_URL="https://www.aimoxt.com/v1" export OPENAI_API_KEY="sk-你的key" export OPENAI_MODEL="deepseek-v4.1-flash"

不同版本的 DeepSeek Harness 字段名可能不同:找 `base_url` / `api_base`、`api_key`、`model` 这三个字段填入即可。

C. OpenAI SDK(Python)

from openai import OpenAI client = OpenAI( base_url="https://www.aimoxt.com/v1", api_key="sk-你的key", ) resp = client.chat.completions.create( model="deepseek-v4.1-flash", messages=[{"role": "user", "content": "用一句话介绍你自己"}], ) print(resp.choices[0].message.content)

D. curl(最快验证 Key 是否可用)

curl https://www.aimoxt.com/v1/chat/completions \ -H "Authorization: Bearer 你的APIKey" \ -H "Content-Type: application/json" \ -d '{"model":"deepseek-v4.1-flash","messages":[{"role":"user","content":"hi"}]}'

E. ChatBox / NextChat / Dify

在「API Host / Base URL」填 `https://www.aimoxt.com/v1`,API Key 填 `sk-...`,模型填表里的模型名。不要选内置的官方模型列表,手动输入模型名最稳。

第 6 步:常见错误怎么排查

现象原因处理
401 / UnauthorizedKey 复制不完整、前后有空格、Key 被禁用重新复制完整 `sk-...`,检查 Key 状态与分组
404 / model not found模型名写错,或该分组没有这个模型用价格表里的模型名;换 0.5/0.8 档试试
429 / rate limit并发或频率超限降低并发/重试;需要更高并发联系客服
余额不足试用金/余额用完钱包充值,或换更便宜的 0.2 档模型
超时长上下文/上游抖动缩短输入、重试;换稳定档或联系客服

常见问题:DeepSeek / cc-switch / DeepSeek Harness

DeepSeek API 怎么接入妙信 AI?

Base URL 填 https://www.aimoxt.com/v1,API Key 填 sk-...,模型名填 deepseek-v4.1-flash 或 deepseek-v4-pro;用 OpenAI 兼容接口发请求即可。

cc-switch 怎么配置?

添加一个 OpenAI 兼容供应商,Base URL 填 https://www.aimoxt.com/v1,API Key 填你的 Key,模型填 deepseek-v4.1-flash;保存后切换到该供应商。

DeepSeek Harness 的 Base URL 填什么?

填 https://www.aimoxt.com/v1;如果工具用环境变量,则设置 OPENAI_BASE_URL、OPENAI_API_KEY、OPENAI_MODEL。

安全提醒

  • API Key 等于钱包;不要发到群里、不要提交到 GitHub、不要写进前端代码。
  • 怀疑泄露就到控制台禁用旧 Key,重新创建一个。
  • 测试先用 10–50 元小额,确认速度和成功率后再加大。

还没注册?先领试用金

跟着上面的步骤做,5 分钟就能发第一条请求。