> 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.

# 个人 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


## 导入

```bash
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 | 错误码    | 场景               |
| ---- | ------ | ---------------- |
| 400  | `1010` | 请求体含未知字段(严格解码)   |
| 401  | `101`  | 凭证无效             |
| 409  | `1006` | 同 `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` 参数引用就绪条目:

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

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

另见[目录与网络需求](https://docs.reelway.ai/api-reference/model-discovery.md)查看平台目录;节点侧的 ComfyUI LoRA 目录见 `GET /v1/worker/config/comfy/loras`(当前返回空目录)。