LiblibAI API怎么用?开发者接口接入完整教程

2026-07-03AI20147

必须通过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 内容,常见原因是提示词含违禁词或分辨率超出模型限制。

《LiblibAI API怎么用?开发者接口接入完整教程.doc》

下载本文的Word格式文档,以方便收藏与打印。