悍匪电商科技开放 API

OpenAI 兼容格式 · 基础地址 https://hanfei.jiankanggongchang.com.cn · 更新日期 2026-10-09

通过开放 API，你可以把平台的大模型出图能力接入自己的独立站、ERP 或脚本：提交生成任务、轮询取图、查询积分。接口采用 OpenAI 兼容格式，已有 OpenAI SDK 的项目基本可以零改造接入。

开放 API 与站内出图共用同一套账号积分。调用产生的消耗按平台当前计费规则从账号积分中扣除。

鉴权方式

除模型列表外，所有接口都需要在请求头携带 API 令牌：

Authorization: Bearer 你的API令牌

令牌仅代表权限，不包含余额快照；实际余额请通过积分查询接口实时获取。

获取令牌

登录平台，进入「个人中心 → API 令牌」页面；
点击「创建新令牌」，勾选所需权限（如生成图片、查询积分）；
复制并妥善保存令牌。令牌仅在创建时显示一次，泄露后请立即撤销重建。

模型列表

GET/api/v1/models

返回当前平台已启用的模型（图片、聊天、视频分类）。无需鉴权。

curl "https://hanfei.jiankanggongchang.com.cn/api/v1/models"

{
  "object": "list",
  "data": [
    {"id": "gpt-image-2.5-sunburst-c", "object": "model", "type": "image", "name": "GPT Image 2.5 Sunburst"}
  ]
}

把返回的 id 作为生成接口的 model 参数即可指定模型；不传则使用平台默认模型。

提交图片生成任务

POST/api/v1/images/generations

创建异步生成任务，立即返回一个带签名的结果地址，用于后续轮询取图。

curl -X POST "https://hanfei.jiankanggongchang.com.cn/api/v1/images/generations" \
  -H "Authorization: Bearer 你的API令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst-c",
    "prompt": "高端白色空气炸锅电商主图，黑金风格，卖点文字清晰",
    "size": "1024x1024",
    "quality": "standard"
  }'

响应：

{
  "created": 1791546977,
  "data": [
    {
      "url": "https://hanfei.jiankanggongchang.com.cn/api/v1/images/result?id=123&sig=xxxxxxxxxxxxxxxxxxxx",
      "revised_prompt": "高端白色空气炸锅电商主图，黑金风格，卖点文字清晰"
    }
  ]
}

请求参数

参数	类型	必填	说明
`prompt`	string	是	画面描述、卖点文案等提示词。
`model`	string	否	模型 `id`，取自模型列表；不传用平台默认模型。
`size`	string	否	像素尺寸（如 `1024x1024`）或比例别名 `1:1` / `2:3` / `3:2` / `9:16` / `16:9`；默认 `1024x1024`。
`quality`	string	否	`standard` 或 `hd`（高清，积分更高）。
`n`	int	否	当前仅支持 `1`，多图请分多次提交。
`input_images`	array	否	参考图数组，元素为 base64 或 `data:image/png;base64,...`；也可写单张字符串。
`mode`	string	否	`draw`（纯文生图）或 `edit`（带参考图）；传了参考图默认 `edit`。
`response_format`	string	否	固定返回签名 URL，如需 base64 请在取图后自行编码。

轮询取图

GET/api/v1/images/result?id={记录ID}&sig={签名}

直接使用提交接口返回的 url 轮询，无需额外鉴权（签名即凭证）：

HTTP 状态	含义	处理方式
`202`	排队或生成中	按响应中的 `retry_after`（秒）后重试。
`302`	生成完成	跟随跳转即可下载图片（`curl -L` 或 SDK 自动跟随）。
`200`	任务失败	响应 JSON 中 `status=failed`，积分自动退还。
`404`	链接无效或记录已删除	检查 `id` 与 `sig` 是否完整。

curl -L "https://hanfei.jiankanggongchang.com.cn/api/v1/images/result?id=123&sig=xxxxxxxxxxxxxxxxxxxx" -o out.png

生成通常需要数分钟。请使用指数退避轮询（例如 3s → 5s → 8s → 13s），避免高频请求。

参考图 / 图生图

把参考图转成 base64 后放进 input_images，即可在产品图基础上改背景、改风格或生成整套详情图：

import base64, json, urllib.request

with open("product.png", "rb") as f:
    b64 = base64.b64encode(f.read()).decode()

payload = {
    "model": "gpt-image-2.5-sunburst-c",
    "prompt": "保留产品外观与颜色，替换为黑金背景，输出电商主图",
    "size": "1024x1024",
    "input_images": [b64],
}

req = urllib.request.Request(
    "https://hanfei.jiankanggongchang.com.cn/api/v1/images/generations",
    data=json.dumps(payload).encode(),
    headers={"Authorization": "Bearer 你的API令牌", "Content-Type": "application/json"},
)
print(urllib.request.urlopen(req).read().decode())

单张参考图建议控制在合理体积，多张参考图请按数组顺序传入；平台会按所选模型能力自动选择处理方式。

积分查询

GET/api/credits

curl "https://hanfei.jiankanggongchang.com.cn/api/credits" \
  -H "Authorization: Bearer 你的API令牌"

{"ok": true, "credits": 76, "username": "yourname"}

错误响应

错误沿用 OpenAI 风格，便于现有 SDK 直接处理：

{
  "error": {
    "message": "积分不足，需要 4 积分。",
    "type": "insufficient_quota",
    "code": 402
  }
}

状态码	type	说明
`400`	invalid_request_error	参数缺失、格式错误或参考图不合法。
`401`	invalid_api_key	令牌缺失、无效或已过期。
`402`	insufficient_quota	积分不足，请先充值。
`403`	permission_error	令牌缺少对应权限。
`405`	invalid_request_error	请求方法不正确。
`500`	server_error	服务内部错误，请稍后重试。

计费说明

画质档位	基础积分（起）	说明
1K	1 积分	常规电商图输出，部分模型单价更高。
2K	2 积分	高分辨率输出，适合详情页与大图展示。
4K	4 积分	仅部分模型支持，不支持时自动降档。

编辑（图生图）模式在对应画质基础上加计。具体到每个模型的实时单价，以站内出图页展示为准；任务失败自动退还积分。

需要接入协助或遇到接口异常，请加微信 liang_0729L 或发邮件至 gusengkeji@163.com，并附上请求时间、模型与订单/记录 ID，便于快速定位。

悍匪电商科技 开放 API