调用说明
FloxAI 提供多种大模型 / 多模态模型的统一调用入口。
- 完整接口清单与参数:以 API 开发文档 为准
- 常见报错排查:见 常见错误以及解决办法
1. 基础地址(Base URL)
所有地址数据互通,可按网络情况切换:
| 节点 | 地址 |
|---|---|
| 全球节点 | https://api.floxai.io |
2. 鉴权方式(Authorization)
您在控制台创建的 API Key 即为调用 API 的凭证,请妥善保管。
| 接口风格 | Base URL | Header | 适用场景 |
|---|---|---|---|
| OpenAI 兼容(推荐) | https://api.floxai.io/v1 | Authorization: Bearer <API_KEY> | 统一调用大多数模型(文本 / 图像 / 音频 / 工具 / 流式等) |
| Claude 原生 | https://api.floxai.io/v1 | x-api-key: <API_KEY> | 需要严格对齐 Anthropic API 形态 / 字段 |
| Gemini 原生 | https://api.floxai.io/v1 | x-goog-api-key: <API_KEY> | 需要严格对齐 Gemini API 形态 / 字段 |
3. 兼容的 API 接口协议
3.1 OpenAI 兼容接口(推荐)
大多数用户只需要这一套:
- ✅ Chat Completions(
/v1/chat/completions) - ✅ Embeddings (
/v1/embeddings) - 正在开发中 Responses(
/v1/responses) - 正在开发中 Images(
/v1/images/*) - 正在开发中 Audio(
/v1/audio/*)
3.2 Anthropic 兼容协议
- ✅ Messages(
/v1/messages)
3.3 Google Gemini 兼容协议
- ✅ Generate Content(
/v1/models/model:generateContent) - ✅ Generate Stream Content(
/v1/models/model:streamGenerateContent)
4. 相关主题
SDK 配置
- OpenAI SDK 设置
- Claude SDK 设置
- Gemini SDK 设置