必须通过LiblibAI官方API调用图像生成服务,流程包括:获取Secret Key和Base URL;用Bearer Token在请求头认证;提交含prompt、model_id等字段的JSON请求;通过task_id轮询/v1/task/{id}获取图片URL。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在自己的程序里调用LiblibAI的图像生成服务,比如让后端自动批量生成封面图或测试素材,必须通过其官方API完成请求、鉴权和结果解析,不能靠网页端手动操作。
获取API密钥和基础配置
登录LiblibAI官网 → 进入「开发者中心」→ 点击「创建新密钥」→ 填写应用名称(如“封面生成服务”)并提交。
生成后立即复制 【Secret Key】,页面关闭后将无法再次查看,丢失需重新生成。
记下你的 【Base URL】,正式环境为 https://api.liblib.ai/v1,测试环境为 https://test-api.liblib.ai/v1,二者不可混用。
构造标准请求头与身份认证
方法一:使用Bearer Token认证
在HTTP请求头中添加:Authorization: Bearer YOUR_SECRET_KEY,注意Bearer后有一个空格。
方法二:使用X-API-Key(部分旧版接口仍支持)
在请求头中添加:X-API-Key: YOUR_SECRET_KEY,但新接口已默认只认Bearer方式,强行用X-API-Key会返回401错误。
发起文生图请求
第一步:准备JSON请求体
必须包含 prompt 字段,且长度不能超过512字符;model_id 必须从官方文档的「可用模型列表」中选取,例如 "flux-dev" 或 "sd-xl-base",填错会直接返回400。
第二步:发送POST请求
php获得文件的mime type类
php获得文件的mime type类
下载
curl -X POST "https://api.liblib.ai/v1/text-to-image" \
-H "Authorization: Bearer sk-xxx" \
-H "Content-Type: application/json" \
-d '{"prompt":"a cyberpunk cat wearing sunglasses, neon lights","model_id":"flux-dev","width":1024,"height":1024}'
第三步:处理响应
成功时返回JSON含 task_id 字段,不是图片URL——你需要用该ID轮询结果接口,等待生成完成。
轮询任务状态并获取图片
向 /v1/task/{task_id} 发起GET请求,建议间隔2秒重试,最多轮询30次。
当返回字段 "status": "success" 时,提取 result.url 即为可公开访问的图片直链。
若返回 "status": "failed",检查 error_message 内容,常见原因是提示词含违禁词或分辨率超出模型限制。
