> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiji.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# 接口概览

> 吉吉API 支持的接口格式、请求地址和鉴权方式。

吉吉API 兼容 OpenAI、Anthropic、Gemini 的官方接口格式。你可以直接使用各家的官方 SDK，只需替换请求地址和 API Key。

## 支持的接口

| 接口 | 请求地址 | 文档 |
| - | - | - |
| OpenAI Chat Completions | `POST https://www.jiji.cc/v1/chat/completions` | [Chat Completions](/api/chat-completions) |
| OpenAI Responses | `POST https://www.jiji.cc/v1/responses` | [Responses](/api/responses) |
| Anthropic Messages | `POST https://www.jiji.cc/v1/messages` | [Messages](/api/messages) |
| Gemini 原生格式 | `POST https://www.jiji.cc/v1beta/models/{model}:generateContent` | [Gemini](/api/gemini) |
| 图像生成 | `POST https://www.jiji.cc/v1/images/generations` | [图像生成](/api/images) |
| 模型列表 | `GET https://www.jiji.cc/v1/models` | 见下方 |

<Tip>
  上表以默认域名 `www.jiji.cc` 为例。也可以换成 CF 优化线路 `api.jiji.cc` 或三网优化线路 `api-slb.jiji.cc`，路径不变。见 [选择线路](/environment/network#选择线路)。
</Tip>

## SDK 的 base URL

各家 SDK 会自动拼接路径，配置 base URL 时要注意是否带 `/v1`：

| SDK | base URL |
| - | - |
| OpenAI SDK | `https://www.jiji.cc/v1` |
| Anthropic SDK | `https://www.jiji.cc` |
| Google Gen AI SDK | `https://www.jiji.cc` |

<Warning>
  Anthropic 和 Gemini 的 SDK 会自动补全 `/v1` 或 `/v1beta`。base URL 多写 `/v1` 会导致请求地址重复，返回 `404`。
</Warning>

## 鉴权

所有接口都使用你在 [API 密钥](https://www.jiji.cc/keys) 页面创建的 Key。

| 接口格式 | 请求头 |
| - | - |
| OpenAI | `Authorization: Bearer your-api-key-here` |
| Anthropic | `Authorization: Bearer your-api-key-here` |
| Gemini | `x-goog-api-key: your-api-key-here` |

<Tip>
  在代码中通过环境变量读取 Key，不要把 Key 直接写进源码。见 [API Key 管理](/account/api-keys)。
</Tip>

## 获取模型列表

返回当前 Key 所在分组可用的模型：

```bash theme={null}
curl https://www.jiji.cc/v1/models \
  -H "Authorization: Bearer your-api-key-here"
```

模型的价格和所属分组见 [模型广场](https://www.jiji.cc/extension/models)。

## 选择接口格式

<AccordionGroup>
  <Accordion title="调用 GPT 系列模型">
    新项目推荐使用 [Responses](/api/responses)，对推理、工具调用的支持更完整。已有项目可以继续使用 [Chat Completions](/api/chat-completions)。
  </Accordion>

  <Accordion title="调用 Claude 系列模型">
    推荐使用 [Anthropic Messages](/api/messages) 原生格式，可以完整使用思考、工具调用、提示词缓存等功能。
  </Accordion>

  <Accordion title="调用 Gemini 系列模型">
    推荐使用 [Gemini 原生格式](/api/gemini)。
  </Accordion>

  <Accordion title="接入第三方应用">
    大多数应用只支持 OpenAI 格式，填写 `https://www.jiji.cc/v1` 作为请求地址即可。见 [更多客户端](/clients/cherry-studio)。
  </Accordion>
</AccordionGroup>

## 错误处理

请求失败时，接口返回对应的 HTTP 状态码和错误信息。各状态码的含义和处理方法见 [错误码速查](/help/error-codes)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.