BBH Image JavaScript SDK

面向 H5 接入的图片生成 SDK

封装模型查询、积分查询、任务提交、轮询等待、临时文件上传、Base64 参考图和多任务提交。接入方只需要引入 `bbh-image-sdk.js`，配置 API Key 后即可调用。

最小调用

const sdk = new BBHImageSDK({
  baseURL: 'https://bbh-ai-server.benbh.cn',
  apiKey: 'sk_your_api_key_here'
});

const result = await sdk.generateImage({
  modelId: '101',
  prompt: 'a cute cat',
  aspect_ratio: '1:1',
  image_size: '1K'
});

SDK 能力

这些是接入时最常用的公开能力，示例页面围绕这些方法展开。

发现模型能力 getModels() 查询可用模型、任务类型、档位、画幅、尺寸、质量和参考图限制。

查询账户积分 getUserPoints() 读取总积分、可用积分和每日赠送积分，便于提交前做余额展示。

提交并等待结果 generateImage() 适合单次生成流程：提交任务、自动轮询、返回图片 URL。

提交和轮询分离 submitImage() + waitForTask() 适合多任务队列：提交后继续操作，每个任务独立等待结果。

URL 参考图 uploadTempFile() 先把本地图片上传为临时 URL，再作为 `images` 参考图提交。

Base64 参考图 fileToDataURL() 把浏览器本地文件转为 Data URI base64，直接放入 `images`。

接入路径

按这个顺序验证 SDK，能覆盖从账号、模型到生成任务的主要流程。

1 查询模型

确认模型 ID、参数、档位和参考图数量限制。

2 查询积分

确认 API Key 可用，并了解账户剩余积分。

3 提交任务

选择文生图、Base64 参考图或 URL 参考图。

4 处理结果

根据场景选择等待单个结果或管理多任务队列。

能力示例

每个页面只验证一个核心能力，方便接入时逐个对照。

01 查询可用模型 演示 `sdk.getModels()`，理解 `task_type`、`param_schema.params`、`tiers`、参考图数量限制。 02 查询积分 演示 `sdk.getUserPoints()`，查看当前 API Key 对应账号的可用积分。 03 快速上手 演示 `sdk.generateImage()` 的最小调用：提交文生图任务、轮询状态、展示生成图片。 04 生图案例1（Base64 参考图） 不传参考图就是文生图；上传 Base64 参考图后接口自动按图生图处理。 05 生图案例2（URL 参考图） 先调用临时文件上传接口获取 URL，再把 URL 作为参考图提交生图任务。 06 生图案例3（多任务提交） 提交后不等待结果，任务在右侧独立轮询；可以继续修改参数提交下一条。