ArtCraft 新手完整指南：安装、登录到首次 AI 创作，一次到位

【免费下载链接】artcraftArtCraft is an intentional crafting engine for artists, designers, and filmmakers项目地址: https://gitcode.com/GitHub_Trending/ar/artcraft

ArtCraft 是面向艺术家、设计师和影视创作者的 AI 创作引擎，官方定位是 "The IDE for artists"。你可以在 2D 画布和 3D 场景中先搭建构图，再调用多模型生成 AI 图片、视频、音频与 3D 资产，把"抽卡"变成可控的工艺创作。本文覆盖安装、登录、首次生成到 3D 进阶工作流，读完即可独立完成自己的第一张图和第一个 3D 场景。

环境准备与安装步骤

这一步的目标是拿到一个能正常启动的桌面应用。

1. Windows / macOS 用户：从官方下载页获取稳定版安装包
2. 解压到任意目录，双击启动即可
3. Linux 用户：先装好 Rust、Node.js（v20+）和 Tauri CLI
4. 克隆仓库，运行一体化启动脚本

git clone https://gitcode.com/GitHub_Trending/ar/artcraft cd artcraft ./script/artcraft/unix_dev.sh

💡 启动器会自动挑选空闲端口（默认从5193起）拉起前端与桌面窗口，端口被占用时自动顺延，不用手动改配置。

完整的构建说明见 dev_setup.md，全部构建脚本（含 Windows 开发脚本）在 script/artcraft/ 目录。

账号登录与权限说明

登录是调用生成模型、查看作品库的前提，两种方式任选其一。

1. 打开应用，进入登录弹窗
2. 方式一：输入邮箱和密码，直接登录或注册
3. 方式二：选择网站登录，浏览器打开审批链接确认后回到应用

💡 登录会话的 Cookie 由 Rust 原生层保存在系统凭据管理器中，不写入网页本地存储；部分功能按账号灰度开放，看不到API Keys入口时说明尚未开通，需联系官方。

会话过期或被撤销时会返回401，重新登录即可，机制细节见 website-login.md。

首次创作教程：从提示词到第一张 AI 图片

这一步完成最小闭环：一段提示词换一张能用的图。

1. 进入创作页，选择图片生成入口
2. 在提示词框描述画面，如"月亮上的酒店，两名宇航员站在月面回望"
3. 选一个图片模型，点击生成

生成不满意时，别只靠反复改提示词——ArtCraft 的核心玩法是把图拖进 2D 画布，用图层、抠图、画笔和局部重绘（inpainting）精确修改指定区域。

💡 局部重绘前先抠图分离主体，涂抹范围越小，模型的改动越可控。

模型怎么选：内置目录与第三方服务商

模型目录很大，按"用途 → 模型族"定位比逐个试错快得多。

1. 先确定用途：图片、视频、音频还是 3D
2. 在对应模型族里挑选，新手不必纠结版本差异
3. 需要 Grok、Midjourney、Sora、World Labs 时，先绑定对应服务商账号

💡 完整的 62 个模型清单在 README.md 的折叠区；目录中标 † 的模型当前停用，标 ‡ 的受限模型暂不对桌面端开放。

进阶工作流：图生视频与 3D 场景创作

两条进阶路径，一条出片，一条出"场景"。

图生视频走"先备首帧、再生成"的路径，出片质量最稳定：

1. 用文生图或画布工具准备一张满意的首帧图片
2. 切换到视频生成，把首帧图设为start frame
3. 选一个视频模型，设置时长和画幅（16:9 / 9:16 / 方形）
4. 提交后等待异步任务轮询完成，即可下载

3D 场景创作的核心是先搭场景、再出图：

1. 用 Image to Location 把图片放进 3D 空间，多镜头共用同一环境
2. 用 3D Image Compositing 分层摆放背景、前景与道具，控制景深
3. 用 Character Posing 在生成前摆好角色姿势、架好相机
4. 用 Image to 3D Mesh 把图片转成可旋转摆放的 3D 物体

💡 视频生成是异步任务，耗时取决于队列长度；接口返回402说明账户credits不足，充值后重试。若要用API Key以编程方式提交任务并轮询inference_job_token，进阶用法见 artcraft_omni_api.md。

常见问题速查表

遇到报错先对照这张表自查，多数问题 1 分钟内能解决。

下一步行动清单

• 确认桌面应用能正常启动，登录状态持续生效
• 用一段提示词生成第一张 AI 图片，并拖进画布做一次局部重绘
• 对照模型目录选定常用模型，绑定需要的第三方服务商
• 完成一次"首帧图片到视频"的图生视频流程
• 把一张图片放进 3D 场景，体验 Image to Location 与 Character Posing
• 想提前了解规划中的能力时，翻一翻 ROADMAP.md

【免费下载链接】artcraftArtCraft is an intentional crafting engine for artists, designers, and filmmakers项目地址: https://gitcode.com/GitHub_Trending/ar/artcraft