# 黑胡子AI便利店

- [黑胡子 AI API](https://docs.heihuzi.ai/cn/index.md): 已按真实生产接口验证的 API 请求和接入示例。
- [认证](https://docs.heihuzi.ai/cn/authentication.md): 三种实测鉴权头，以及实际触发的错误。
- [Responses](https://docs.heihuzi.ai/cn/api-reference/responses.md): 文本、流式、图片识别、多轮对话和函数调用的完整实测示例。
- [Chat Completions](https://docs.heihuzi.ai/cn/api-reference/chat-completions.md): gpt-5.5 的 messages 请求、普通响应与流式响应。
- [Models](https://docs.heihuzi.ai/cn/models.md): 查询当前 Key 可见模型，并选择已经实测的调用入口。
- [DeepSeek 接入](https://docs.heihuzi.ai/cn/api-reference/deepseek/index.md): 模型选择、三种调用协议与便利店实际验证范围。
- [DeepSeek Chat Completions](https://docs.heihuzi.ai/cn/api-reference/deepseek/chat-completions.md): 已实测的 JSON、普通文本和流式调用。
- [DeepSeek Responses](https://docs.heihuzi.ai/cn/api-reference/deepseek/responses.md): 普通响应、无状态多轮上下文和 SSE 完成处理。
- [DeepSeek Messages](https://docs.heihuzi.ai/cn/api-reference/deepseek/messages.md): Anthropic SDK 调用地址、文本提取和流式完成条件。
- [DeepSeek 工具调用](https://docs.heihuzi.ai/cn/api-reference/deepseek/tools.md): Chat Completions 与 Responses 的两轮真实工具闭环。
- [DeepSeek 图片理解](https://docs.heihuzi.ai/cn/api-reference/deepseek/vision.md): Flash 在三种协议下的单张 PNG 图片识别示例。
- [DeepSeek 兼容性与限制](https://docs.heihuzi.ai/cn/api-reference/deepseek/compatibility.md): 本轮真实验证通过的模型、参数组合和完成条件。
- [Claude Code Messages](https://docs.heihuzi.ai/cn/api-reference/messages.md): 已验证 Sonnet 5、Opus 5、Haiku 的 Messages 调用。
- [模型与调用结果](https://docs.heihuzi.ai/cn/api-reference/claude-code.md): 当前 Messages 模型的实际调用结果。
- [GPT Image 2.5 图像生成](https://docs.heihuzi.ai/cn/api-reference/images/gpt-image-2.5/generation.md): 经过生产 API 验证的生成请求、参数组合和图片响应。
- [GPT Image 2.5 图像编辑](https://docs.heihuzi.ai/cn/api-reference/images/gpt-image-2.5/edits.md): 参考图上传、Data URL、公开 URL、多图、遮罩和流式编辑的完整实测示例。
- [GPT Image 2.5 流式返回](https://docs.heihuzi.ai/cn/api-reference/images/gpt-image-2.5/streaming.md): 生成和编辑均经过真实 SSE 调用、预览与最终图片检查。
- [GPT Image 2 图像生成](https://docs.heihuzi.ai/cn/api-reference/images/gpt-image-2/generation.md): gpt-image-2 的生成接口、独立请求示例和已测参数范围。
- [GPT Image 2 图像编辑](https://docs.heihuzi.ai/cn/api-reference/images/gpt-image-2/edits.md): gpt-image-2 的单图文件上传、JSON Data URL 和已测编辑参数。
- [Codex懒人一键安装指南](https://docs.heihuzi.ai/cn/integrations/lazy-installer.md): 按图完成 Windows 安装包下载、API Key 配置、中文界面切换和首次对话。
- [用户指南](https://docs.heihuzi.ai/cn/user-guide/index.md): 从 Key、模型和图片结果开始使用 API。
- [API Key 使用](https://docs.heihuzi.ai/cn/user-guide/api-keys.md): 用对应能力的 Key 查询模型并运行示例。
- [模型与接口](https://docs.heihuzi.ai/cn/user-guide/models.md): 按当前已经实测的协议选择具体模型 ID。
- [GPT Image 使用指南](https://docs.heihuzi.ai/cn/user-guide/gpt-image-2.md): 三个图片模型的实测入口和参数阅读位置。
- [参考图与遮罩](https://docs.heihuzi.ai/cn/user-guide/image-edits.md): 已测单图、两张参考图和局部添加物体的编辑流程。
- [常见问题](https://docs.heihuzi.ai/cn/faqs/index.md): 按认证、模型或图片响应查找实测排查信息。
- [认证与权限排查](https://docs.heihuzi.ai/cn/faqs/auth-and-permissions.md): 通过已复现的鉴权和权限错误定位问题。
- [模型选择问题](https://docs.heihuzi.ai/cn/faqs/models.md): 模型列表与对应接口的实测范围。
- [图片常见问题](https://docs.heihuzi.ai/cn/faqs/images.md): 图片权限、流式预览、编辑输入和异步接口的实测结果。

## OpenAPI Specs

- [responses](/openapi/responses.json)