控制台
API 文档

MaxModel API 接入

一个密钥、一个端点，兼容 OpenAI、Claude、Gemini 三大主流协议。把任意 OpenAI 兼容客户端的 Base URL 指向 MaxModel，即可调用 GPT、Claude、Gemini、DeepSeek、通义千问、Grok、文心、豆包等模型。

概览

MaxModel 是 AI 模型 API 中转网关。对外提供与 OpenAI 完全兼容的接口，同时支持 Claude（Anthropic Messages）与 Gemini 的原生协议。你无需改动现有代码，只需替换 Base URL 与密钥。

BASE https://api.maxmodel.com/v1
  • OpenAI 兼容：/v1/chat/completions、/v1/responses、/v1/embeddings、/v1/images/generations、/v1/video/generations、/v1/models。
  • Claude 原生：/v1/messages（Anthropic Messages API 格式）。
  • Gemini 原生：/v1beta/models/{model}:generateContent。
控制台：密钥申请、用量与额度查询、模型与价格，请前往 www.maxmodel.com。api.maxmodel.com 仅供程序调用，不提供网页操作界面。

快速开始

  1. 登录 控制台，在「令牌 / API Keys」创建一个密钥（形如 sk-...）。
  2. 将客户端的 Base URL 设为 https://api.maxmodel.com/v1。
  3. 用密钥发起请求即可。
cURL
curl https://api.maxmodel.com/v1/chat/completions \
  -H "Authorization: Bearer $MAXMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "用一句话介绍你自己"}]
  }'

鉴权

所有请求通过 HTTP 头携带密钥（Bearer Token）：

Authorization: Bearer <YOUR_API_KEY>
请妥善保管密钥。密钥等同于账户额度的支配权，不要写入前端代码或提交到公开仓库。如发生泄露，请立即在控制台禁用并重建。

对话补全 POST

POST /v1/chat/completions

OpenAI Chat Completions 标准接口。常用参数：

参数类型说明
modelstring模型 ID，见可用模型。
messagesarray对话消息列表，每项含 role 与 content。
streambool是否流式返回（SSE），默认 false。
temperaturenumber采样温度，0–2，默认随模型。
max_tokensint生成的最大 token 数（可选）。

Python（openai SDK）

Python
from openai import OpenAI

client = OpenAI(
    api_key="$MAXMODEL_API_KEY",
    base_url="https://api.maxmodel.com/v1",
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js（openai SDK）

Node.js
import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.MAXMODEL_API_KEY,
  baseURL: 'https://api.maxmodel.com/v1',
});

const resp = await client.chat.completions.create({
  model: 'gemini-2.5-flash',
  messages: [{ role: 'user', content: '你好' }],
});
console.log(resp.choices[0].message.content);

流式输出

设置 "stream": true，服务端以 SSE 逐块下发 data: 事件，最后以 data: [DONE] 结束。

cURL
curl https://api.maxmodel.com/v1/chat/completions \
  -H "Authorization: Bearer $MAXMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role": "user", "content": "写一首关于海的短诗"}],
    "stream": true
  }'

文本向量 POST

POST /v1/embeddings
cURL
curl https://api.maxmodel.com/v1/embeddings \
  -H "Authorization: Bearer $MAXMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "需要向量化的文本"
  }'

图像生成 POST

POST /v1/images/generations

文生图 / 图生图，兼容 OpenAI Images 接口。支持 gpt-image-2 · gpt-image-1.5 · gpt-image-1、imagen-4.0-ultra-generate-001、gemini-3-pro-image-preview、qwen-image-max 等。返回 b64_json 或 url，按张或按 token 计费。

cURL
curl https://api.maxmodel.com/v1/images/generations \
  -H "Authorization: Bearer $MAXMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只在月球上的橘猫，写实风格",
    "size": "1024x1024"
  }'

视频生成 POST

POST /v1/video/generations

文生视频，异步任务：提交后返回 task_id，再轮询任务状态获取结果。支持 doubao-seedance-2-0、veo-3.1-generate-preview 等。

cURL · 提交
curl https://api.maxmodel.com/v1/video/generations \
  -H "Authorization: Bearer $MAXMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0",
    "prompt": "海浪拍打礁石，慢镜头电影质感"
  }'

返回 {"task_id":"...","status":"queued"}，随后按 task_id 轮询结果：

cURL · 查询
curl https://api.maxmodel.com/v1/video/generations/{task_id} \
  -H "Authorization: Bearer $MAXMODEL_API_KEY"
veo 按秒计费（可传字符串参数 "seconds": "8"）；seedance 按次计费。具体单价见模型页与控制台。

Responses API POST

POST /v1/responses

OpenAI Responses 接口。部分 OpenAI 高阶推理模型（如 gpt-5.5-pro）仅支持此端点，用 /v1/chat/completions 调用会返回 "This is not a chat model" 错误。输出文本在 output[].content[].text（type: output_text）。

cURL
curl https://api.maxmodel.com/v1/responses \
  -H "Authorization: Bearer $MAXMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5-pro",
    "input": "用一句话介绍你自己"
  }'
怎么选端点：普通对话模型用 /v1/chat/completions；-pro 等 OpenAI 高阶推理模型用 /v1/responses。不确定某模型走哪个，可在模型页查看或先用 responses 试。

模型列表 GET

GET /v1/models

返回当前密钥可访问的模型 ID 列表。建议以此接口或控制台为准，模型会随渠道动态调整。

cURL
curl https://api.maxmodel.com/v1/models \
  -H "Authorization: Bearer $MAXMODEL_API_KEY"

Claude 原生接口 POST

POST /v1/messages

若你的代码使用 Anthropic 官方 SDK 或 Messages API 格式，可直接对接此端点（请求体与 Anthropic 一致）。

cURL
curl https://api.maxmodel.com/v1/messages \
  -H "x-api-key: $MAXMODEL_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'
使用 Anthropic SDK 时，将 base_url 设为 https://api.maxmodel.com，密钥填 MaxModel 密钥即可。

Gemini 原生接口 POST

POST /v1beta/models/{model}:generateContent
cURL
curl "https://api.maxmodel.com/v1beta/models/gemini-2.5-flash:generateContent" \
  -H "x-goog-api-key: $MAXMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "你好"}]}]
  }'

可用模型

MaxModel 接入下列模型家族。完整实时列表见模型页，或调用 /v1/models（也可在控制台查看）。下表为示例 ID 与对应调用方式：

家族示例模型 ID调用方式
OpenAI GPTgpt-5.5 · gpt-4o · gpt-4o-mini对话补全
OpenAI 推理 / Progpt-5.5-pro · o3 · o4-miniResponses API
OpenAI 图像gpt-image-2 · gpt-image-1.5图像生成
Anthropic Claudeclaude-opus-4-8 · claude-sonnet-4-6 · claude-haiku-4-5-20251001对话补全 / Claude 原生
Google Geminigemini-3.5-flash · gemini-3.1-pro-preview · gemini-2.5-pro对话补全 / Gemini 原生
Google 图像 / 视频imagen-4.0-ultra-generate-001 · veo-3.1-generate-preview图像 / 视频生成
DeepSeekdeepseek-chat · deepseek-reasoner对话补全
通义千问 Qwenqwen3-max · qwen-max · qwen-plus对话补全
xAI Grokgrok-4.3 · grok-4对话补全
百度文心ernie-5.1 · ernie-5.0 · ernie-x1.1对话补全
字节豆包doubao-seed-2-0-pro · doubao-seedance-2-0对话补全 / 视频生成

用 list.json 程序化获取模型与接口

https://www.maxmodel.com/models/list.json 提供机器可读的完整在售模型清单（每日更新、支持跨域）。每个模型带一个 endpoint 字段，标明该用哪个接口调用；顶层 endpoint_paths 给出 token → 实际路径的映射。

endpoint实际路径适用
chat/v1/chat/completions普通对话 / 视觉 / o 系列推理
responses/v1/responsesOpenAI 高阶推理（如 gpt-5.5-pro），不能走 chat
image/v1/images/generations图像生成
video/v1/video/generations视频生成（异步）
embedding/v1/embeddings文本向量
tts / transcription/v1/audio/speech · /v1/audio/transcriptions语音合成 / 转写
用 endpoint 字段就能自动给每个模型选对接口，无需硬编码。例：gpt-5.5-pro 的 endpoint 是 responses → 应调用 /v1/responses。
Python
import requests

data = requests.get("https://www.maxmodel.com/models/list.json").json()
paths = data["endpoint_paths"]                 # {"chat": "/v1/chat/completions", ...}

for m in data["models"]:
    print(m["id"], "->", paths[m["endpoint"]]) # 每个模型该用的接口路径
# 例如：gpt-5.5-pro -> /v1/responses

计费说明

MaxModel 按 用量（token）计费：每次请求消耗的输入与输出 token 数 × 对应模型单价。不同模型单价不同，输入与输出可能采用不同费率。

  • 额度与消费明细实时显示在控制台。
  • 同一密钥可调用所有已开通模型，按实际所用模型计价。
  • 用户组（普通 / VIP / SVIP）对应不同价格倍率，详见控制台定价页。

错误码

错误以标准 HTTP 状态码 + JSON 错误体返回（OpenAI 错误结构）：

状态码含义常见原因
400请求错误参数缺失或格式错误。
401未授权密钥缺失、无效或已禁用。
403禁止访问密钥无权访问该模型。
429请求过多 / 额度不足触发限流，或账户余额不足。
500 / 502 / 503服务端错误上游渠道异常，可重试或更换模型。

限流与配额

  • 每个密钥可在控制台设置额度上限与有效期。
  • 触发限流返回 429，建议客户端实现指数退避重试。
  • 长文本 / 流式生成的连接超时上限为 600 秒。
  • 单请求体上限 100 MB（满足多模态 / 大上下文场景）。

常见问题

可以直接用 OpenAI 官方 SDK 吗？

可以。只需把 base_url 改为 https://api.maxmodel.com/v1、api_key 改为 MaxModel 密钥，其余代码无需改动。

Base URL 要不要加 /v1？

OpenAI 兼容客户端通常填 https://api.maxmodel.com/v1；部分 SDK 会自动补 /v1，此时填 https://api.maxmodel.com 即可。Claude/Gemini 原生接口见对应章节。

为什么浏览器打开 api.maxmodel.com 没有界面？

api.maxmodel.com 是纯 API 端点，仅供程序调用。网页操作（密钥、用量、计费）请使用控制台。

支持哪些模型？怎么查最新列表？

访问模型页、调用 /v1/models，或登录控制台查看实时可用模型与价格。