鸿蒙API 使用文档

本文档用于帮助用户快速接入鸿蒙API New API 中转服务，支持 OpenAI 兼容格式，可用于官方 AI 前端、第三方 AI 软件、插件和开发项目。

鸿蒙API AI 前端展示图

鸿蒙API AI 前端支持对话、生图、模型切换和令牌接入。

一、接口地址怎么填

二、生图模型怎么填

图片模型请填写平台提供的模型名，不要自行填写上游原始模型名。 如果多个上游都叫 gpt-image-2 ，平台会用不同后缀区分渠道。

用户调用 gpt-image-2-adobe 时，系统会自动转发到对应渠道的上游模型 gpt-image-2。 用户不要直接填写 gpt-image-2，避免多个渠道重名导致混淆。

三、图片生成示例

curl https://ai.hmapi.top/v1/images/generations \
  -H "Authorization: Bearer sk-你的API令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2-adobe",
    "prompt": "一只橘色小猫，高清，柔和光线",
    "size": "1024x1024"
  }'

四、聊天接口示例

curl https://ai.hmapi.top/v1/chat/completions \
  -H "Authorization: Bearer sk-你的API令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {
        "role": "user",
        "content": "你好"
      }
    ]
  }'

五、第三方前端填写方式

六、生图接口说明

不同前端的生图方式不同。有些前端调用 /v1/images/generations， 有些前端会把图片模型当成聊天模型调用 /v1/chat/completions。 是否支持取决于第三方前端本身。

如果前端支持 OpenAI 图片接口，优先使用：

https://ai.hmapi.top/v1/images/generations

如果前端只能通过聊天接口调用图片模型，则使用：

https://ai.hmapi.top/v1/chat/completions

七、常见错误

• Invalid token：API Key 无效。请在控制台"令牌管理"重新创建令牌。不要使用上游渠道密钥，不要写成 sk-sk-xxxx。
• UND_ERR_CONNECT_TIMEOUT / fetch failed： 客户端连接超时。图片生成可能需要 20-90 秒，第三方前端超时时间建议设置为 120-180 秒。
• model not found：模型名填写错误，或账号分组没有该模型权限。图片模型请填写 gpt-image-2-adobe。
• 404：接口地址填写错误。Base URL 应填写 https://ai.hmapi.top/v1，不要漏掉 /v1，也不要写成 /v1/v1。
• 返回一大段很长的字符：通常是图片 base64 数据，说明图片生成成功。前端需要把 base64 转换成图片显示。

统一接口信息

快速开始

如果你是第一次使用，可以按照下面步骤操作：

1. 打开网站：https://ai.hmapi.top/
2. 注册并登录账号。
3. 进入后台创建 API 令牌。
4. 复制生成的 API Key。
5. 如果使用官方 AI 前端，打开： https://ai.hmapi.top/
6. 在前端页面点击 令牌，粘贴 API Key 并保存。
7. 选择对话、生图或视频模型，即可开始使用。
8. 如果使用第三方软件，则填写接口地址： https://ai.hmapi.top/v1 和 API Key。

第三方软件通常需要填写：

API地址：https://ai.hmapi.top/v1

API Key：后台创建的令牌

接口地址说明

不同软件对接口地址的填写方式可能略有不同。常见填写方式如下：

https://ai.hmapi.top/v1
https://ai.hmapi.top/v1/chat/completions
https://ai.hmapi.top/v1/images/generations

模型名称说明

模型名称需要填写后台实际支持的模型名称。常见示例：

auto
gpt-4o-mini
gpt-4o
deepseek-v4-flash
deepseek-v4-pro
gemini-3-flash
gemini-3.1-pro-high
gemini-3.1-pro-low
gpt-image-1
gpt-image-1.5
gpt-image-2

注意：模型名称可能会随平台调整而变化，请以后台实际显示为准。

分组说明

创建令牌时，可以根据需要选择不同分组。不同分组可能对应不同模型权限和计费倍率。

如何创建 API 令牌

API 令牌是调用接口时必须使用的身份凭证，也就是 API Key。

创建步骤

1. 登录 https://ai.hmapi.top/
2. 进入后台控制台。
3. 点击左侧菜单中的 API令牌 。
4. 点击 添加令牌。
5. 填写令牌名称，例如：AI前端专用、ChatBox专用、项目测试。
6. 选择令牌分组。
7. 按需设置额度限制、过期时间和模型限制。
8. 保存并复制 API Key。

令牌安全建议

• 不要把 API Key 发到群聊、截图、视频、公开网站或 GitHub。
• 建议每个令牌设置额度限制，避免误用或被盗刷。
• 不同应用创建不同令牌，方便后续单独删除和统计。
• 如果怀疑泄露，请立即删除旧令牌并重新创建。

使用日志查看

如果请求失败，可以进入后台查看使用日志。常见信息包括：

• 调用时间
• 调用模型
• 消耗额度
• 请求状态
• 错误原因

鸿蒙API AI 前端使用教程

鸿蒙API AI 前端是平台提供的在线使用页面，支持对话模型、生图模型、视频入口、模型切换、上下文开关等功能。 用户无需自己配置复杂参数，只需要在控制台创建 API 令牌，然后在前端页面输入令牌即可使用。

前端入口

前端填写令牌

1. 打开控制台：https://ai.hmapi.top/
2. 注册并登录账号。
3. 进入后台后，点击左侧菜单中的 API令牌 。
4. 点击 添加令牌。
5. 填写令牌名称，例如：AI前端专用、生图测试 、聊天使用。
6. 选择可用分组，建议根据需要选择支持对话和生图的分组。
7. 保存后复制生成的 API Key。
8. 打开 AI 前端：https://ai.hmapi.top/
9. 点击左侧 令牌 或 API Key 设置 。
10. 粘贴 API Key 并保存。

前端对话模型使用

1. 点击左侧 对话。
2. 在模型列表中选择需要使用的对话模型，例如 auto、deepseek-v4-pro、 gemini-3-flash 等。
3. 在底部输入框输入问题。
4. 点击发送，即可获得 AI 回复。

对话示例

请帮我写一份小红书文案，主题是冬天、旅行、治愈感、爱情。

前端生图模型使用

1. 点击左侧 生图。
2. 选择可用的生图模型，例如 gpt-image-1 、gpt-image-1.5 、gpt-image-2 等。
3. 在底部输入框输入图片描述词。
4. 选择图片尺寸，例如 1024x1024。
5. 点击发送，等待图片生成。
6. 生成完成后，可以点击图片查看大图，也可以点击下载保存。

生图提示词示例

古风女子，面部特写，精致五官，清澈明亮的眼睛，细腻皮肤，柔和自然光，
古典发簪，淡雅妆容，汉服领口细节，东方美人，温柔气质，
电影级光影，真实皮肤纹理，高清人像摄影，8K，ultra detailed，best quality

参考图/改图使用

如果前端已开启参考图或改图功能，可以上传图片作为参考，让模型基于原图进行风格改造、细节调整或重新生成。

1. 切换到 生图 模式。
2. 上传一张参考图片。
3. 输入改图要求，例如：改成古风、换背景、增强清晰度、保持人物五官不变等。
4. 点击发送，等待生成结果。

改图提示词示例

请基于这张图片进行古风写真改造，保持人物五官和脸型一致，
换成淡绿色汉服，增加发簪和柔和逆光，背景虚化，画质清晰，自然真实。

AI 前端常见问题

开发接入示例

ChatBox 配置

1. 打开 ChatBox。
2. 进入设置。
3. 选择 OpenAI API 或自定义 OpenAI。
4. API 地址填写： https://ai.hmapi.top/v1
5. API Key 填写后台创建的令牌。
6. 模型填写后台支持的模型名称。
7. 保存后开始使用。

Cherry Studio 配置

1. 打开 Cherry Studio。
2. 进入设置 / 模型服务。
3. 添加 OpenAI 兼容服务。
4. 服务地址填写： https://ai.hmapi.top/v1
5. API Key 填写你的令牌。
6. 添加模型名称并保存。

NextChat 配置

如果使用 Docker 部署，可以参考：

docker run -d \
  -p 3000:3000 \
  -e OPENAI_API_KEY="你的API_KEY" \
  -e BASE_URL="https://ai.hmapi.top" \
  yidadaa/chatgpt-next-web

部分版本也可以使用：

OPENAI_API_KEY=你的API_KEY
OPENAI_BASE_URL=https://ai.hmapi.top/v1

Open WebUI 配置

docker run -d \
  -p 3000:8080 \
  -e OPENAI_API_BASE_URL="https://ai.hmapi.top/v1" \
  -e OPENAI_API_KEY="你的API_KEY" \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

LobeChat 配置

OPENAI_API_KEY=你的API_KEY
OPENAI_PROXY_URL=https://ai.hmapi.top/v1

SillyTavern 配置

1. 打开 SillyTavern。
2. 进入 API Connections。
3. API 类型选择 OpenAI。
4. API 地址填写： https://ai.hmapi.top/v1
5. API Key 填写后台令牌。
6. 模型填写后台支持的模型名称。

curl 调用示例

curl https://ai.hmapi.top/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {
        "role": "user",
        "content": "你好，请介绍一下你自己"
      }
    ]
  }'

Python 配置方式

安装依赖：

pip install openai

调用示例：

from openai import OpenAI

client = OpenAI(
    api_key="你的API_KEY",
    base_url="https://ai.hmapi.top/v1"
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[
        {"role": "user", "content": "你好，帮我写一段自我介绍"}
    ]
)

print(response.choices[0].message.content)

Node.js 配置方式

安装依赖：

npm install openai

调用示例：

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "你的API_KEY",
  baseURL: "https://ai.hmapi.top/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [
    {
      role: "user",
      "content": "你好，帮我写一篇短文"
    }
  ],
});

console.log(response.choices[0].message.content);

绘图模型使用

如果平台已开通绘图模型，可以使用图片生成接口。

curl https://ai.hmapi.top/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的API_KEY" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "一只可爱的橘猫坐在窗边，动漫风格",
    "size": "1024x1024"
  }'

绘图模型名称、图片尺寸和计费规则请以后台实际显示为准。

常见错误

联系客服

如果不会配置，或者不确定选择哪个模型、哪个分组，可以联系客服协助处理。

TG客服：@hongm77

TG群组：https://t.me/hmapiai

在线时间：早上 10:00 - 晚上 11:00

网站地址：https://ai.hmapi.top/

AI 前端：https://ai.hmapi.top/