接口文档
本章节介绍 FreeAPI 代理服务支持的主要 API 接口，涵盖 OpenAI、Anthropic、Gemini 三家主流大模型的原生格式，以及图像生成相关接口。
通用说明
接入地址
| 接口格式 | Base URL |
|---|---|
| OpenAI（Chat Completions / Responses / Images） | https://www.free-api.ai/api/v1 |
| Anthropic Messages | https://www.free-api.ai/api |
| Gemini | https://www.free-api.ai/api |
鉴权方式
所有接口均使用 Bearer Token 鉴权，在请求头中添加：
http
Authorization: Bearer your-api-key对于 Anthropic Messages 接口，也支持 x-api-key 请求头：
http
x-api-key: your-api-keyWARNING
建议优先使用模型官方原生格式：
- 调用 Claude 系列模型时，优先使用 Anthropic Messages 格式；
- 调用 GPT / OpenAI 系列模型时，优先使用 OpenAI Chat Completions 或 OpenAI Responses 格式；
- 调用 Gemini 系列模型时，优先使用 Gemini generateContent 格式。
跨格式调用（例如通过 OpenAI 格式调用 Claude、或通过 OpenAI 格式调用 Gemini 生成图像）由代理侧进行字段转换，可能存在功能缺失、参数不兼容或行为不一致等问题。具体支持范围与已知差异请咨询 FreeAPI。
接口列表
对话 / 推理
- OpenAI Chat Completions —
POST /v1/chat/completions - OpenAI Responses —
POST /v1/responses - Anthropic Messages —
POST /v1/messages - Gemini generateContent —
POST /v1beta/models/{model}:generateContent
图像生成
- Gemini 原生格式图像生成 — 推荐，使用
generateContent的图像模态 - OpenAI 兼容格式图像生成 — 通过
/v1/images/generations调用 Gemini 图像模型