---
title: API 网关配置规范
description: 配置国内或国际 API 基础地址、请求路径、鉴权头和代理超时，并用最小请求验证连通性。
---

本指南旨在帮助开发者正确配置无限星河AI 的中转网关，让您的应用更稳定、安全地调用顶尖大模型。

---

## 接口地址

无限星河AI 提供统一的 API 入口，所有模型请求均通过该网关进行智能调度。

* **国内网络优先**：`https://infistar.cc/v1`
* **国际地址**：`https://infistar.ai/v1`
* **协议支持**：仅支持 HTTPS 加密传输。


---

## 身份认证

我们采用标准的 **Bearer Token** 认证机制，兼容 OpenAI 常用鉴权格式。

### 配置方式
在您的 HTTP 请求 Header 中添加以下字段：
`Authorization: Bearer 您的API_KEY`

### 注意事项
* **安全性**：API Key 等同于您的账户资产。请勿将 Key 直接硬编码在前端代码（如 HTML/JS）中，建议通过后端中转调用，防止 Key 被恶意抓取。
* **状态检查**：若鉴权失败，系统将返回 `401 Unauthorized` 状态码。

---

## 网络连接建议

为了获得最佳的调用体验，建议在配置时参考以下网络参数：

1.  **超时时间 (Timeout)**：
    推理模型可能需要较长时间，建议将客户端请求超时设置为 **60 秒 - 180 秒**。
2.  **长连接支持**：
    网关支持 `Connection: keep-alive`，建议开启以减少频繁握手带来的延迟。
3.  **流式输出 (Stream)**：
    强烈建议开启 `stream: true` 模式。这不仅能提供“打字机”式的用户体验，还能在长文本生成过程中有效避免因前端等待时间过长而导致的连接超时。

![网络响应延迟对比图](/图片/网关配置-流式输出说明-网络响应延迟对比图.webp)

---

## 跨域配置（CORS）

如果您是在浏览器环境中直接调用（仅限测试场景），我们的网关已默认允许跨域请求。但为了生产环境的安全，我们依然推荐使用服务器后端代理。

---

## 快速验证

您可以使用以下 cURL 命令快速测试网关连通性：

```bash
curl https://infistar.cc/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 您的API_KEY" \
  -d '{
    "model": "qwen-plus",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
```

如果模型 ID 不可用，请到[模型广场](https://infistar.cc/pricing)复制当前模型 ID，不要使用模型中文名。

令牌创建与权限问题请查看[身份认证与权限管理](/integration-guides/authentication-permissions)，各类兼容接口入口请查看[API 总览](/api-overview)。