希望让用户在您的网站上输入文字后,无需跳转到LiblibAI界面,就能直接在自己的页面内完成AI绘图?实际上,这需要调用LiblibAI开放的API接口,而非通过网页端操作实现。

确认是否具备API调用权限
目前,LiblibAI仅向企业认证账户及合作开发者开放图像生成API,个人免费账号无法获取有效的API Key。登录后台后,请进入「开发者中心」→「API管理」页面。若页面显示“暂未开放”或未提供创建按钮,则说明当前账户不符合开通条件。
您需要先完成企业实名认证,并提交用途说明(例如“用于某某正式内容配图”),待审核通过后,系统才会发放api_key和base_url。如果未经授权强行发送请求,将返回403错误,且无法查看调试日志。
接入前准备三项关键材料
方法一:从LiblibAI控制台直接复制
登录企业账号 → 进入「开发者中心」→ 点击「新建API密钥」→ 填写应用名称(例如“正式图文生成插件”)→ 提交后立即获得三段式凭证:【api_key】、【model_id】(如seedream-4.0)、【endpoint】(如https://api.liblib.art/v1/text2image)。这三项缺一不可,缺少model_id会导致请求被拒绝。
方法二:用已有模型ID反查
如果您已知某个模型在网页端的ID(例如从URL中提取model=Qwen-Image),可以访问https://api.liblib.art/v1/models(需携带Header:Authorization: Bearer YOUR_API_KEY),从而获取完整的支持列表,确认该模型是否已启用API调用权限。需要注意的是,部分社区模型(如用户自制的LoRA)默认关闭了API通道。
前端调用示例(JavaScript)
第一步:构造请求体
请确保用户输入的提示词经过UTF-8编码,且长度不超过300个字符;负向提示词(negative_prompt)为可选字段,但建议填入通用的降噪词,例如“blurry, deformed, text, watermark”,以避免低质量输出。
第二步:设置请求头
必须包含Content-Type: application/json和Authorization: Bearer 【你的api_key】,若缺少任一Header将触发401错误。
第三步:发起POST请求
使用fetch发送至【你的endpoint】,Body结构如下:
{
"prompt": "水墨江南,青瓦白墙,撑油纸伞的少女侧影",
"negative_prompt": "blurry, deformed, text, watermark",
"model_id": "【你的model_id】",
"width": 1024,
"height": 1024,
"steps": 30
}
第四步:处理响应
请求成功时,返回的JSON中会包含task_id字段,需要轮询/v1/tasks/{task_id}直到status变为success,再提取result_url——该URL有效期仅为5分钟,必须立即下载或转存至自己的CDN上。
