HakanAI 文档 | 图像生成接口

Hakan AI 提供与 OpenAI 完全兼容的图像生成接口 POST /v1/images/generations，可直接用于文生图场景。已上架 gpt-image-2、nano-banana 系列、seedream 系列和 Gemini 图像预览模型等。

接口地址

端点	方法	说明
`https://hakanaiktn.com/v1/images/generations`	`POST`	OpenAI 兼容图像生成端点

Base URL：https://hakanaiktn.com/v1

认证方式

所有请求需要在 Header 中携带 API Key：

Authorization: Bearer sk-xxxxxxxx
Content-Type: application/json

请求参数

参数	类型	必填	说明
`model`	string	✅	图像生成模型名，例如 `gpt-image-2`、`nano-banana-pro`
`prompt`	string	✅	图像生成提示词
`size`	string		输出尺寸，如 `1024x1024`、`1536x1024`；不传时使用模型默认
`n`	integer		单次生成图片数量，默认 `1`

部分模型有额外的可选参数（如 quality、response_format、background 等），行为与 OpenAI 官方文档一致。

支持的模型

模型	系列	说明
`gpt-image-2`	OpenAI	主推稳定通道，兼容 OpenAI `images.generate`
`nano-banana-1`	Nano Banana	轻量图像生成
`nano-banana-2`	Nano Banana	Nano Banana 二代
`nano-banana-pro`	Nano Banana	Pro 版本，画质更高
`gemini-2.5-flash-image`	Gemini	Gemini 快速图像生成
`gemini-3-pro-image-preview`	Gemini	Gemini 3 Pro 图像预览
`gemini-3.1-flash-image-preview`	Gemini	Gemini 3.1 Flash 图像预览
`seedream-4.5`	Seedream	Seedream 4.5
`seedream-4.6`	Seedream	Seedream 4.6
`seedream-5`	Seedream	最新 Seedream

最新的完整模型清单与价格请以模型广场为准。

快速开始

cURL

curl https://hakanaiktn.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A cute Japanese idol producer business card design, pale yellow and white color scheme, premium fan merchandise style",
    "size": "1536x1024",
    "n": 1
  }'

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxx",
    base_url="https://hakanaiktn.com/v1",
)

response = client.images.generate(
    model="gpt-image-2",
    prompt="A cute Japanese idol producer business card design, pale yellow and white color scheme, premium fan merchandise style",
    size="1536x1024",
    n=1,
)

print("图片地址:", response.data[0].url)

JavaScript / Node.js

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-xxxxxxxx',
  baseURL: 'https://hakanaiktn.com/v1',
});

const response = await client.images.generate({
  model: 'gpt-image-2',
  prompt: 'A minimal illustration of a banana on a clean white background',
  size: '1024x1024',
  n: 1,
});

console.log(response.data[0].url);

响应格式

{
  "created": 1782833913,
  "background": "opaque",
  "data": [
    {
      "url": "https://r2.geeknow.top/magic/image-generation-xxxxxxxx.png"
    }
  ],
  "output_format": "png",
  "quality": "auto",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 16,
    "output_tokens": 765,
    "total_tokens": 781
  }
}

data 是数组，元素个数等于 n。每个元素通常包含 url 字段，直接可以下载。

部分模型可能返回 b64_json 字段（图片的 Base64 编码）而不是 url。为兼容两种情况，建议在客户端做如下判断：
item = response.data[0]
if getattr(item, "url", None):
    image = download(item.url)
elif getattr(item, "b64_json", None):
    image = base64.b64decode(item.b64_json)

调用其它图像模型

所有图像模型都走同一个端点 POST /v1/images/generations，只需要更换 model 字段：

# Nano Banana
curl https://hakanaiktn.com/v1/images/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "A simple banana on a clean white background, minimal illustration",
    "size": "1024x1024"
  }'

# Seedream
response = client.images.generate(
    model="seedream-5",
    prompt="A scenic mountain landscape at sunset, cinematic lighting",
    size="1024x1024",
)