用途:Lovart API 用于 AI 驱动的设计生成,适合在用户需要生成图像、视频、3D 内容或做图像放大等场景中调用。接口基址为 https://lgw.lovart.ai。
主要能力:核心端点为 POST /v1/openapi/chat,发送自然语言提示即可生成图像、视频等视觉内容,并返回 thread_id 用于跟踪;通过 GET /v1/openapi/chat/status 查询状态(running、done、pending_confirmation、failed)与进度;GET /v1/openapi/chat/result 获取生成的图像或视频 URL;POST /v1/openapi/chat/confirm 在高成本操作(如视频生成)处于 pending_confirmation 时确认;POST /v1/openapi/project/save 创建项目并获取 project_id;POST /v1/openapi/mode/set 与 /v1/openapi/mode/query 切换和查询快速模式与无限模式。可用模型覆盖 IMAGE、VIDEO、3D 与 UTILITY 四类,例如 generate_image_flux_2_max、generate_video_veo3_1、generate_3d_tripo、upscale_image,可通过 tool_config 的 prefer_tool_categories 或 include_tools 指定。
使用方式:所有请求使用 AK/SK HMAC-SHA256 签名,需要环境变量 LOVART_ACCESS_KEY(ak_…)与 LOVART_SECRET_KEY(sk_…),并在请求头携带 X-Access-Key、X-Timestamp、X-Signature、X-Signed-Method、X-Signed-Path。签名内容为 METHOD\nPATH\nTIMESTAMP。示例命令:TIMESTAMP=$(date +%s) && SIGNATURE=$(echo -ne "POST\n/v1/openapi/chat\n${TIMESTAMP}" | openssl dgst -sha256 -hmac "$LOVART_SECRET_KEY" | awk '{print $NF}') 后以 curl 发请求。请求体包含 prompt 与 project_id,可加 thread_id 续聊、attachments 传参考图、tool_config 指定模型。
适用场景:AI 设计、生成图像、生成视频、AI 艺术、产品摄影等。
限制:签名含时间戳,每次请求需重新计算,服务端拒绝过期签名;X-Signed-Path 必须与实际路径完全一致且不含查询字符串;所有 chat 请求都需 project_id,须先创建项目;图像生成通常 10-30 秒,视频可能数分钟,需轮询状态;pending_confirmation 时不得自动确认,应先询问用户,可能消耗额度;快速模式(unlimited: false)消耗额度用于优先处理,无限模式(unlimited: true)免费但可能排队。故障排查可用 okou doctor check-connector --env-name LOVART_ACCESS_KEY 或 okou doctor check-connector --url https://lgw.lovart.ai/v1/openapi/mode/query --method POST。文档见 https://lovart.info/lovart-api 与 https://lovart.info/lovart-ai-code。