For AI agents: the complete documentation index is available at https://docs.reelway.ai/llms.txt, the full documentation bundle is available at https://docs.reelway.ai/llms-full.txt, and this page is available as Markdown at https://docs.reelway.ai/api-reference/personal-loras.md.

个人 LoRA

个人 LoRA 库允许账户把自有权重(以 URL source 登记的元数据档)作为私有 LoRA 管理,并在生成请求的 loras 参数中引用。每账户保留近 200 条记录。

GEThttps://rcn.reelway.ai/v1/loras/personal鉴权:凭证

近 200 条,{loras[]}

GEThttps://rcn.reelway.ai/v1/loras/personal/catalog鉴权:凭证

就绪导入条目 {loras[{id, name, baseModelId}]}

GEThttps://rcn.reelway.ai/v1/loras/personal/{id}鉴权:凭证

单条;不存在返回 404

POSThttps://rcn.reelway.ai/v1/loras/personal鉴权:凭证

导入;202 受理

DELETEhttps://rcn.reelway.ai/v1/loras/personal/{id}鉴权:凭证

注销;不存在返回 404

导入

curl --fail-with-body -X POST https://rcn.reelway.ai/v1/loras/personal \
  -H "api-key: $REELWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "https://example.com/weights.safetensors",
    "name": "my-style-lora",
    "baseModelId": "qwen_image_2512_fp8"
  }'

202 表示什么

导入是受理即返回:响应 202 含 LoRA 条目形状。条目状态 status 随导入器推进:当前实现为占位导入器——条目立即置 ready,但没有权重落盘;真实拉取(从 source URL 拉取权重文件)待后续版本接入。

预览导入器为占位实现:条目立即 ready 但无权重落盘;契约稳定,M2 接入真实拉取

导入错误

HTTP错误码场景
4001010请求体含未知字段(严格解码)
401101凭证无效
4091006同 source 已存在
422—source 非有效 URL

查看、目录与删除

  • GET /v1/loras/personal 返回近 200 条 {loras[]}:id / name / source / baseModelId / status / createdAt / updatedAt。
  • GET /v1/loras/personal/catalog 仅返回 ready 条目的精简形状,用于生成前的可引用性检查。
  • DELETE /v1/loras/personal/{id} 注销条目;不存在返回 404。

在生成中使用

生成请求的 keyFrames[0].loras 与 SDK projects.create 的 loras 参数引用就绪条目:

const project = client.projects.create({
  modelId: 'qwen_image_2512_fp8',
  positivePrompt: '一杯手冲咖啡,水彩风格',
  loras: [{ id: 'my-style-lora', strength: 0.8 }],
});
使用前提

当前节点配置未挂载个人 LoRA 权重,生成侧对 loras 的支持尚未打通;引用就绪条目暂不改变渲染行为。以本页状态徽标与本站公告为准。

另见目录与网络需求查看平台目录;节点侧的 ComfyUI LoRA 目录见 GET /v1/worker/config/comfy/loras(当前返回空目录)。