m1f API 中转网关 —— OpenAI/Anthropic/Gemini 统一 API 接入指南

m1f API 是一个高性能、稳定可靠的 AI API 中转网关服务，基于 PHP 开发，为开发者和企业提供统一的 AI 模型调用入口。无论你使用 OpenAI、Anthropic、Google Gemini 还是 DeepSeek，只需接入 m1f API，即可通过 OpenAI 或 Anthropic 原生格式调用所有主流模型。

服务架构

m1f API 采用多层分布式架构，确保服务的高可用性和低延迟：

接入层：Cloudflare CDN 全球加速，DDoS 防护，SSL 终结
代理层：云服务器作为公网入口，通过 FRP 隧道与内网服务通信
服务层：网关服务 Nginx → PHP-FPM + APIO Relay
数据层：MySQL 存储配置与日志，SQLite 作为回退，确保高可用

用户请求路径：浏览器/应用 → Cloudflare CDN → 云服务器 → FRP 隧道 → 树莓派 → Nginx → PHP-FPM 网关

核心功能

多模型支持：兼容 OpenAI、Anthropic Claude、Google Gemini、DeepSeek 等主流 AI 模型，持续更新
双格式输出：同时支持 OpenAI Chat Completions 和 Anthropic Messages 原生格式，一行代码切换模型提供商
智能路由：自动选择最优可用通道，权重负载均衡+超时自动切换，保障服务稳定性
格式转换：OpenAI ↔ Anthropic ↔ Gemini 格式自动互转，无需关心底层差异
流式传输：完整的 SSE 流式支持，实时获取模型响应，兼容各类 SDK
实时监控：完整的调用日志、用量统计、费用管理和数据看板
安全管理：Token 鉴权、用户权限控制、操作审计、模型级权限管理
钱包计费：按量计费，预充值，消费明细一目了然

快速开始

1. 获取 API Key

2. 使用 OpenAI SDK 调用（/v1/chat/completions）

m1f API 完全兼容 OpenAI API 格式，只需修改 base URL 和 API Key 即可：

from openai import OpenAI

client = OpenAI(
    base_url="https://apio.m1f.cn/v1",
    api_key="your-api-key-here"
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)

3. 使用 cURL 测试

curl https://apio.m1f.cn/v1/chat/completions \
  -H "Authorization: Bearer your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

4. 使用 Anthropic SDK 调用（/v1/messages）

/v1/messages 端点返回原生的 Anthropic Messages 格式，可直接使用 Anthropic SDK：

import anthropic

client = anthropic.Anthropic(
    base_url="https://apio.m1f.cn",
    api_key="your-api-key-here"
)

response = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)
print(response.content[0].text)

也可通过 cURL 直接调用：

curl https://apio.m1f.cn/v1/messages \
  -H "Authorization: Bearer your-api-key-here" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'