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

# OpenAI · 概览

> 了解如何通过 HingNet AI 使用 OpenAI 兼容接口，并快速跳转到常用能力。

HingNet AI 为 OpenAI 生态提供兼容代理层：

* **官方兼容边界清晰**：在官方分组 / 官方渠道下，保持与官方 REST API 对齐，可直接复用现有 SDK/代码。
* **统一认证**：使用 HingNet AI 控制台签发的 Token 即可访问多个渠道，支持细粒度的密钥权限与监控。
* **多云路由**：同一套调用可在 HingNet AI 控制台中按需切换后端供应商或冗余策略。

<Note>
  填写 `Authorization: Bearer <HingNet AI Token>` 作为认证头。
</Note>

<Note>
  如果你的账号同时接入官方和灰色渠道，请把 OpenAI 兼容承诺限定在官方分组 / 官方渠道，并参考 [Sora 视频路由与分组](/guide/sora-video-routing) 做分组隔离。
</Note>

```bash theme={null}
export BASE_URL="https://models.hingnet.com.cn"
export TOKEN="oh-xxxxxxxxxxxxxxxx"
```

配置好环境变量后，可直接用 cURL 调试：

```bash theme={null}
curl "$BASE_URL/v1/models" \
  -H "Authorization: Bearer $TOKEN"
```

## 快速入口

<CardGroup cols={2}>
  <Card title="聊天补全" icon="comments" href="/openai/chat-completions">
    经典对话、函数调用与流式输出。
  </Card>

  <Card title="Responses 多模态" icon="wand-magic-sparkles" href="/openai/responses">
    统一回应接口，支持文本、图像、结构化输出。
  </Card>

  <Card title="向量检索" icon="vector-square" href="/openai/embeddings">
    text-embedding 系列模型生成语义向量。
  </Card>

  <Card title="内容安全" icon="shield" href="/openai/moderations">
    omni moderation 的风险检测。
  </Card>

  <Card title="音频处理" icon="music" href="/openai/audio-speech">
    文本转语音、语音转写能力。
  </Card>

  <Card title="图像与视频" icon="photo-film" href="/openai/images">
    gpt-image-1、gpt-image-2、dall-e 与 Sora 视频生成。
  </Card>
</CardGroup>

更多接口详情请通过左侧导航进入对应页面，或直接展开自动生成的 OpenAPI 参考。
