要打通这套流程，得先搞定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: YOUR_SECRET_KEY 来认证。但新接口已经默认只接受Bearer方式，如果强行使用旧的X-API-Key，返回的将会是401错误。所以建议直接采用Bearer方式，一步到位。

发起文生图请求

第一步是准备JSON请求体。这里面有两个关键字段：prompt 是图像描述文本，长度不能超过512个字符；model_id 必须从官方文档的「可用模型列表」里选择，比如 "flux-dev" 或 "sd-xl-base"。填错了模型ID，将直接返回400错误。

第二步是发送POST请求。一个典型的调用示例如下：

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 字段——注意，这不是图片链接，而是任务ID。你需要用这个ID去轮询生成结果，等图片真正渲染完成才能拿到最终地址。

轮询任务状态并获取图片

拿到的 task_id 怎么用？向 /v1/task/{task_id} 发起GET请求，建议每2秒重试一次，最多轮询30次。如果返回的 "status": "success"，那就说明图片已经生成完毕，从 result.url 字段里提取出来的就是可以直接访问的图片直链。

如果返回的是 "status": "failed"，那就需要查看 error_message 里给出的具体原因。最常见的错误包括：提示词中含有违禁词汇，或者请求的分辨率超出了模型支持的范围。根据提示调整参数，重新提交即可。