API 参考

API 文档

兼容 OpenAI 的图像、视频和文本生成 API。无缝替换 — 只需更改 Base URL。

兼容 OpenAI

使用官方 OpenAI SDK，只需更改 Base URL 和 API Key，现有代码即刻生效。

安全可靠

所有请求通过 HTTPS 加密传输。API Key 支持权限控制，可随时撤销。

全球加速

多区域分布式基础设施，全球低延迟访问。

快速开始

获取 API Key

注册账号并在控制台创建 API Key。新用户赠送免费余额。

安装 SDK

使用官方 OpenAI SDK，或直接发送 HTTP 请求。

# cURL 无需安装

发起第一次 API 调用

一次 API 调用即可生成图片。将 YOUR_API_KEY 替换为你的实际密钥。

curl -X POST https://api.hiapi.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "Nano-Banana-Pro", "stream": false, "messages": [{"role": "user", "content": "Draw a cute cat"}]}'

认证方式

所有 API 请求需要在 Authorization 请求头中以 Bearer Token 形式传递 API Key。

Authorization: Bearer YOUR_API_KEY

请勿在客户端代码或公开仓库中暴露 API Key。请使用环境变量安全存储。

Base URL

所有 API 端点基于此 Base URL。如果使用 OpenAI SDK，将其设置为 base_url 参数。

https://api.hiapi.ai/v1

API 端点

对话补全（图像生成）

POST/v1/chat/completions

通过对话式 API 生成高质量图像。使用 Nano-Banana-Pro 获得最佳画质（可配置宽高比和分辨率），或使用 Nano-Banana 快速生成。

参数

参数名	类型	必填	说明
model	string	必填	Nano-Banana-Pro（高质量）或 Nano-Banana（快速）
messages	array	必填	消息对象数组，包含 role 和 content
stream	boolean	可选	启用流式响应（默认：false）
extra_body.google.image_config.aspect_ratio	string	可选	图像宽高比：1:1、16:9、9:16、4:3、3:4（默认：1:1）
extra_body.google.image_config.image_size	string	可选	图像分辨率：1K（1024px）或 2K（2048px，仅 Pro）

代码示例

curl -X POST https://api.hiapi.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Nano-Banana-Pro",
    "stream": false,
    "messages": [
      {
        "role": "user",
        "content": "Draw a cute cat sitting on a windowsill"
      }
    ],
    "extra_body": {
      "google": {
        "image_config": {
          "aspect_ratio": "1:1",
          "image_size": "1K"
        }
      }
    }
  }'

错误处理

API 使用标准 HTTP 状态码。错误响应返回包含详细信息的 JSON 对象。

状态码	说明
400	请求错误 — 参数无效或缺少必填字段
401	未授权 — API Key 无效或缺失
403	禁止访问 — 权限不足或账户已暂停
429	请求过多 — 超出速率限制，请降低请求频率
500	服务器错误 — 服务端出现问题，请稍后重试

错误响应格式

{
  "error": {
    "message": "Invalid token",
    "type": "new_api_error",
    "code": ""
  }
}

准备好开始了吗？

获取 API Key，几分钟内即可开始生成图像、视频等内容。