快速开始

准备三项信息

Base URL

https://api.mallowapi.com/v1

API Key

控制台「API 密钥」页创建的 sk-…

模型

gpt-6.1-sol（日常主力）或 gpt-6-luna（最便宜）

不同客户端对 Base URL 的叫法不一样：API 地址、Endpoint、接口地址、Override Base URL，填的都是同一个值。

三步跑通

1. 创建 API Key

   在登录页登录后进入控制台，打开「API 密钥」，点「创建密钥」。厂商选 OpenAI 就能调用 GPT 系列模型。详见创建 API Key。

2. 确认地址和密钥可用

   先把密钥放进环境变量，再请求模型列表。这一步不生成内容，不消耗 token。

   export MALLOW_API_KEY="sk-你的密钥"
   
   curl https://api.mallowapi.com/v1/models \
     -H "Authorization: Bearer $MALLOW_API_KEY"

   返回一串模型 ID，说明网络、地址和密钥都没问题。Windows PowerShell 用 $env:MALLOW_API_KEY = "sk-你的密钥" 设置变量，并把 curl 写成 curl.exe。

3. 发第一条请求

   curl https://api.mallowapi.com/v1/chat/completions \
     -H "Authorization: Bearer $MALLOW_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "gpt-6.1-sol",
       "messages": [{"role": "user", "content": "用一句话介绍你自己"}]
     }'

   看到 choices[0].message.content 里有回复就成功了。这条请求会按实际 token 扣费，金额很小；想再省一点，把模型换成 gpt-6-luna。

Base URL 常见填错

少数客户端（例如 Cherry Studio）会自动补 /v1，具体看对应教程。

接下来

• 用 Codex 写代码：Codex CLI 配置
• 在自己的程序里调用：OpenAI SDK 示例
• 不确定用哪个模型：模型列表
• 出现报错：错误码排查