必须轮询task_id获取结果直链,仅当提交返回code为0且含task_id时才可轮询;轮询需用新时间戳等四参数get请求,间隔2~3秒;成功时取result_url,失败或超120秒应终止并重提任务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

LiblibAI API提交文生图或图生图任务后,必须通过轮询机制主动查询task_id对应的任务状态,服务端不会主动推送完成通知,不轮询就永远拿不到图片直链。
获取task_id并确认请求成功
调用/api/generate/webui/text2img或/api/generate/webui/img2img接口后,检查返回JSON体:【若code字段不为0,或根本不存在task_id字段,说明参数校验失败,此时不可进入轮询流程】。常见失败原因包括AccessKey错误、Signature签名过期、提示词为空、分辨率非法(如低于512×512)等。
只有当返回中明确包含"code": 0和"task_id": "xxx"时,才可进行下一步。
开始轮询获取结果URL
轮询必须使用GET方法,请求地址为https://openapi.liblibai.cloud/api/generate/task?task_id=xxx,需携带全部原始认证参数:AccessKey、Signature、Timestamp、SignatureNonce——【这四个参数缺一不可,且Timestamp必须是本次轮询发起时的新时间戳,不能复用提交任务时的老时间戳】。
轮询间隔建议设为2~3秒,太短可能触发限流,太快也无意义,首张图生成通常需8~25秒;若连续5次返回"status": "processing",请立即停止轮询并检查模型是否在个人库中已加载。
当返回JSON中出现"status": "success"且含"result_url"字段时,该URL即为最终生成图的直链,有效期24小时,可直接下载或嵌入网页。
处理失败与超时情况
方法一:收到"status": "failed"时,直接读取"error_message"内容,常见值如"model_not_found"表示模型名拼写错误或未加入个人库,"out_of_quota"表示算力点耗尽,"image_decode_error"多因图生图上传的base64字符串损坏或非JPEG/PNG格式。
方法二:轮询超过120秒仍无"success"响应,应终止请求,此时大概率是任务被服务端丢弃——不要重试相同task_id,需重新提交新任务获取新task_id。
注意:轮询过程中若返回"code": 403,说明Signature签名失效,需立即用最新Timestamp+Nonce重新计算签名,旧签名在5分钟内即失效。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











