# Digilifeform AI 大图生成器
当用户提到以下任一意图时，应优先使用本技能：
把文本、文档或已有图片转换为高质量信息海报，并支持继续修图。
当前能力包括：
16:9、21:9、4:3、1:1、3:4、9:16、9:21、1:3、3:14kmagic_wand、deep_research 或 magic_think。当用户提供或指向一张已有图片、海报、生成结果、截图、二维码、logo 或上一轮任务结果，并提出以下任一修改意图时，必须调用 POST /api/edit/create：
这种情况下不要调用 /api/datu/create，也不要调用 /api/datu/create-from-file 重新生成一张新图。
路由字段：
imageannotated_imageref_imagespromptparent_task_id只有当用户明确要求“解析这张图/截图里的内容，再生成一张新的大图/海报”时，图片才作为内容素材进入大图生成流程。
对于大图生成，外层代理必须遵守以下规则：
magic_wand=true 时，敏感信息检查通过后，不要先做摘要、提炼、压缩、重写或“整理版 Prompt”deep_research=true 只能在用户明确选择或确认后启用；深度研究会全网深度抓取并分析，通常需要额外 5-15 分钟，并额外消耗 5 积分research_report_download_url 时下载或提供深度研究报告文件magic_wand 都已明确，就直接创建任务，不要额外输出“整理后的执行方案”让用户确认magic_wand=false 时也不要改写用户输入，应直接传递用户给出的原始信息所有文本、文件、图片 URL 或参考图在提交到 https://datu.digilifeform.com 前，都应先做一次轻量敏感信息检查。以下内容如果明显出现，不应跳过确认上传到外部服务，而应先提醒并获得用户明确授权：
说明：
接口：
POST /api/datu/create
请求体：
{
"text": "用户提供的完整信息",
"aspect_ratio": "16:9",
"resolution": "4k",
"magic_wand": true,
"deep_research": false
}
字段说明：
text: 必填，最短支持 2 个字符aspect_ratio: 16:9 / 21:9 / 4:3 / 1:1 / 3:4 / 9:16 / 9:21 / 1:3 / 3:1resolution: 4kmagic_wand: 默认 truedeep_research: 默认 false。只能在用户明确选择或确认后设为 true。设为 true 时，Datu 会先进行全网深度抓取与分析，再生成大图；这会额外增加约 5-15 分钟，并额外消耗 5 积分注意：
magic_wand=true 不等于外层代理先提炼资料deep_research=true 会强制使用 magic_wand=truedeep_research=true 只能在用户明确选择或确认后启用深度研究请求示例：
{
"text": "请基于以下完整资料先做全网深度研究，再生成一张行业趋势信息海报：......",
"aspect_ratio": "16:9",
"resolution": "4k",
"magic_wand": true,
"deep_research": true
}
接口：
POST /api/datu/create-from-file
请求格式：multipart/form-data
字段：
fileaspect_ratioresolutionmagic_wanddeep_research支持上传：
pdfdocdocxtxtmdmarkdownpngjpgjpegwebpgif限制：
20MBdeep_research=true 时同样提交原始文件，由 Datu 内部解析、研究、整理和生成接口：
POST /api/edit/create
请求体：
{
"image": "https://cdn.example.com/original.png",
"annotated_image": "",
"ref_images": [],
"prompt": "把顶部主标题做得更醒目，整体改成深蓝金科技风",
"magic_think": true,
"aspect_ratio": "9:16",
"resolution": "4k",
"parent_task_id": null
}
字段说明：
image: 必填，原图 URLannotated_image: 可选，标注图 URLref_images: 可选，最多 4 张prompt: 必填，最短 2 个字符magic_think: 默认 trueaspect_ratio: 16:9 / 21:9 / 4:3 / 1:1 / 3:4 / 9:16 / 9:21 / 1:3 / 3:1resolution: 4k说明：当前版本已取消新建 8K 任务，不要再传 resolution=8k。
大图状态：
GET /api/datu/status/{task_id}
如果用户选择深度研究，状态或任务详情中可能包含：
{
"image_url": "https://cdn.example.com/datu/final.png",
"download_url": "/api/tasks/DT1234567890/download",
"research_report_download_url": "/api/tasks/DT1234567890/research-report-link"
}
遇到 research_report_download_url 时，应再请求：
GET /api/tasks/{task_id}/research-report-link
返回值中的 download_url 是短期有效的 Word .docx 报告下载地址。执行时应下载深度研究报告。最终回复用户时，如果用户选择深度研究，应同时给出图片结果和研究报告文件；报告文件建议命名为 research-report-{task_id}.docx。
修图状态：
GET /api/edit/status/{task_id}
本技能需要一个用户自行创建并控制的 Datu API Key。推荐在运行环境中配置：
DATU_API_KEY=your_api_key_here
宿主凭据要求：
DATU_API_KEY 持久凭据X-API-Key 发送DATU_API_KEY，应优先提示用户检查宿主的凭据/密钥库/技能授权设置，而不是让用户在聊天里反复粘贴 key所有请求都使用：
X-API-Key: your_api_key_here
基础地址：
https://datu.digilifeform.com
隐私提示：
https://datu.digilifeform.com 外部服务magic_wand 主流程开关，默认开启deep_research 深度研究开关；开启后结果应包含图片和 Word .docx 深度研究报告文件magic_think，与大图主开关分离9:16、9:21、1:3、3:1 已作为正式比例支持4k 生图 / 改图默认优先走新的高质量链路，失败时自动回退GET /api/skill/version推荐提醒文案：
检测到 Datu 大图技能有新版本 vX.Y.Z，建议在 ClawHub 更新后继续使用。
magic_wanddeep_researchmagic_wand错误：
用户要 Datu 大图，却改用其他生图工具直接生成
正确：
使用 /api/datu/create 或 /api/datu/create-from-file
magic_think 当成大图生成开关错误：
大图生成时发送 magic_think
正确：
大图生成用 magic_wand，修图才用 magic_think
错误：
把所有非 21:9 的请求都当成 16:9，或忽略用户明确选择的 9:16 / 9:21 / 1:3 / 3:1
正确：
保留用户明确选择的 9:16 / 9:21 / 1:3 / 3:1
错误：
用户给了一整段资料或一个文件，外层代理先整理成几条 bullet，再把这个缩写版发给 Datu
正确：
magic_wand=true 时，先做上传前安全检查；通过后不要压缩整理摘要总结用户信息，而是保真提交给大图技能
错误：
识别到文档中有密钥、身份证号或受限信息，但未提醒用户确认就提交到外部 API
正确：
先提醒风险并取得明确授权；用户不确认时停止上传或请用户提供脱敏版本
错误：
用户选择了 deep_research=true，但最终只返回图片链接，忽略 research_report_download_url
正确：
如果用户选择深度研究，任务完成后同时提供图片和 Word `.docx` 深度研究报告文件
错误：
用户之前已经提供并成功使用过 Datu API Key，但每次在飞书、微信等宿主里调用技能时仍要求重新提供
正确：
宿主收到用户提供的 key 后，应保存为 `DATU_API_KEY` 持久凭据；后续调用自动注入并通过 `X-API-Key` 发送。只有持久凭据缺失、被删除、失效或认证失败时，才提示用户重新配置。
共 2 个版本