哈基米API站

Appearance

图像接口 ​

图像接口用于文生图、图片编辑和图生图。本站同时提供 OpenAI 兼容的 Images 格式，以及部分模型的对话式生图能力。实际可用模型请以控制台模型列表为准。

接口信息 ​

接口方法完整请求地址用途
Images GenerationsPOSThttps://api.gemai.cc/v1/images/generations文本生成图片
Images EditsPOSThttps://api.gemai.cc/v1/images/edits图片编辑、图生图
Chat CompletionsPOSThttps://api.gemai.cc/v1/chat/completions使用对话格式调用部分生图模型

文本生成图片 ​

OpenAI Images 格式 ​

INFO

适合支持 OpenAI Images API 的程序。prompt 是图片提示词，model 请填写本站支持生图的模型名。

bash
curl --location 'https://api.gemai.cc/v1/images/generations' \
  --header 'Authorization: Bearer sk-你的令牌' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "一只橘猫坐在赛博朋克风格的城市屋顶，电影感光影",
    "size": "1024x1024",
    "n": 1
  }'

返回结果 ​

INFO

不同模型可能返回图片 URL 或 Base64。拿到 URL 后可以直接下载或展示；拿到 Base64 时需要自行保存为图片文件。

json
{
  "created": 1741569952,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}

图片编辑 ​

multipart/form-data 格式 ​

INFO

图片编辑通常使用 multipart/form-data 上传原图。Windows PowerShell 调用 multipart 不如 curl 直观，建议使用 Git Bash、WSL 或后端代码发起请求。

bash
curl --location 'https://api.gemai.cc/v1/images/edits' \
  --header 'Authorization: Bearer sk-你的令牌' \
  --form 'model="gpt-image-2"' \
  --form 'image=@"./input.png"' \
  --form 'prompt="把图片改成日系插画风格，保留主体构图"' \
  --form 'size="1024x1024"'

对话格式生图 ​

Chat Completions 调用 ​

INFO

部分支持生图的模型也可以走 /v1/chat/completions。这种方式适合已经接入聊天接口，但想让模型在对话中返回图片的客户端。

bash
curl --location 'https://api.gemai.cc/v1/chat/completions' \
  --header 'Authorization: Bearer sk-你的令牌' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "[官]gemini-3.1-flash-image-preview",
    "messages": [
      {
        "role": "user",
        "content": "生成一张 16:9 的猫咪咖啡馆宣传图，温暖灯光，细节丰富。"
      }
    ]
  }'

JavaScript 示例 ​

保存图片 URL ​

INFO

下面示例演示如何读取图片生成结果。如果接口返回的是 Base64，请把 url 的读取逻辑改成 b64_json。

javascript
const response = await fetch('https://api.gemai.cc/v1/images/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.GEMAI_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'gpt-image-2',
    prompt: '一只橘猫坐在赛博朋克风格的城市屋顶',
    size: '1024x1024',
    n: 1,
  }),
})

const data = await response.json()
console.log(data.data?.[0]?.url)

注意事项 ​

  • 生图模型、尺寸、比例和返回格式可能因模型而异，请以模型说明为准。
  • 图片编辑需要上传文件，不能只传本地路径字符串给 JSON 接口。
  • 大尺寸图片生成耗时更久，建议客户端设置较长超时时间。
  • 如果对话式生图不返回图片，优先检查模型是否支持图片输出，以及客户端是否能展示图片结果。