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

# 黑胡子 AI API

> 已按真实生产接口验证的 API 请求和接入示例。

API 地址：**`https://code.heihuzi.ai`**。文档验证日期：**2026-09-10**。

备用域名：如果你所在地区或当前网络无法访问 heihuzi.ai，可使用 [vim27.cc](https://vim27.cc) 访问便利店，使用 [docs.vim27.cc/cn](https://docs.vim27.cc/cn) 阅读 API 文档。API 备用入口为 `https://vim27.cc`；切换时只替换域名，保留原有接口路径。具体地址对照见[常见问题](/cn/faqs)。

本手册列出的请求、参数组合和代码示例已通过该地址实际调用。图片结果检查了编码、尺寸、数量及透明通道；流式检查了真实事件和最终图片。具体模型与组合范围列在对应接口页。

## 接口入口

| 能力               | 接口                            |
| ---------------- | ----------------------------- |
| 查询模型             | `GET /v1/models`              |
| Responses        | `POST /v1/responses`          |
| Chat Completions | `POST /v1/chat/completions`   |
| Messages         | `POST /v1/messages`           |
| 图片生成             | `POST /v1/images/generations` |
| 图片编辑             | `POST /v1/images/edits`       |

从[快速验证](/cn/quickstart)开始，或查看[集成指南](/cn/integrations/index)。所有请求都应使用与目标能力对应的 Key，认证和已复现错误见[认证](/cn/authentication)。

图片 API 按版本分组：GPT Image 2.5 提供生成、编辑和流式文档；GPT Image 2 提供独立的[生成](/cn/api-reference/images/gpt-image-2/generation)和[编辑](/cn/api-reference/images/gpt-image-2/edits)文档。模型选择统一见[图片使用指南](/cn/user-guide/gpt-image-2)。

## DeepSeek

已新增 [DeepSeek 接入](/cn/api-reference/deepseek/index)，按模型列出通过验证的接口：Flash 的三种协议及流式、JSON、工具闭环、图片理解。验证日期为 2026-09-19，公开参数与完整示例均有对应的实测通过记录。