可灵AI支持四种参考素材导入方式：一、项目设置页上传并启用；二、提示词中嵌入[ref:img\_xxx]标记；三、从素材库关联已存分组；四、通过API注入元数据并引用ref_id。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您在使用可灵AI时希望让生成内容更贴合特定风格、语调或视觉元素，则需要将参考素材正确导入并关联至当前项目。以下是实现参考素材上传与关联的具体操作步骤：
一、通过项目设置页上传参考图片或文档
该方法适用于需为整个项目设定统一参考基准的场景，系统会将上传文件作为全局提示依据参与生成过程。
1、进入可灵AI主界面，点击右上角头像，选择“我的项目”。
2、找到目标项目，点击右侧“设置”图标（齿轮形状）。
3、在设置面板中定位到“参考素材”区域，点击“上传文件”按钮。
4、从本地选择单张图片（支持PNG、JPG、WEBP格式，≤10MB）或PDF文档（≤50页，文字可识别）。
5、上传成功后，系统自动显示文件缩略图及格式标识，此时需手动点击“启用此素材作为参考”开关，否则不参与生成。
二、在提示词编辑框内嵌入本地图片链接
该方法适用于单次生成任务中动态插入视觉锚点，尤其适合多轮迭代时替换不同参考图。
1、在生成界面打开提示词输入框，将光标置于需要插入参考的位置。
2、点击输入框上方工具栏中的“图片图标”按钮（方形带山形轮廓）。
3、在弹出窗口中选择“从本地上传”，选取一张符合尺寸要求的图像（建议分辨率≥720×720像素）。
4、上传完成后，系统自动生成一段形如[ref:img_8a3f2d]的标记代码，必须保留在提示词中且不可修改或删除该代码。
5、提交生成请求前，确认提示词末尾未出现重复的[ref:]标记，同一提示词中最多允许嵌入3个独立参考图标记。
三、使用已保存的素材库快速关联
该方法适用于频繁复用相同参考素材的用户，可提前归档常用图片、配色方案或排版截图，提升后续调用效率。
1、点击左侧导航栏“素材库”，进入个人素材管理页。
2、点击“新建分组”，命名为“品牌VI”“产品原型”等便于识别的名称。
3、在对应分组内点击“上传素材”，支持批量拖入图片或PDF文件。
4、上传完毕后，鼠标悬停在某素材缩略图上，点击浮现的“关联至项目”按钮。
5、在弹出的选择框中勾选一个或多个当前处于“编辑中”状态的项目，关联后该素材即刻生效，无需重启生成流程。
四、通过API接口批量注入参考素材元数据
该方法面向开发者或高级用户，适用于需将外部设计系统、CMS内容或A/B测试样本自动同步至可灵AI的集成场景。
1、在“开发者中心”获取当前项目的API密钥及Endpoint地址。
2、构造POST请求，Header中包含Authorization: Bearer {your_api_key}。
3、Body使用JSON格式，包含字段"ref_type"（值为"image"或"document"）、"ref_url"（公网可直访的HTTPS链接）、"ref_weight"（数值0.3–0.9，默认0.6）。
4、发送请求后接收返回的ref_id字符串，须将该ref_id填入后续生成请求的prompt参数中，格式为[ref:{ref_id}]。
5、验证是否生效：调用GET /v1/projects/{project_id}/refs接口，检查返回列表中status字段是否为"active"。
