Feat/readme image examples

README.md

@@ -30,7 +30,7 @@ https://github.com/user-attachments/assets/ae8923ce-e03e-473c-8e75-941bcb945f9c
 
 ## Quick Start
 
-**Recommended model: Qwen 3.8 Flash.** It costs about 1/140 of GPT 6 Astra and reaches a similar result. We recommend using it.
+**Recommended model: Qwen 3.8 Flash.** It costs about 1/150 of GPT 6 Astra and reaches a similar result. We recommend using it.
 
 Works with **ChatGPT / Codex**, **Qoder**, **Claude Code**, **Cursor** and any agent with skills support. You need Python 3.11+, Node.js 20.6+, and either [uv](https://docs.astral.sh/uv/) or pipx.
 
@@ -121,6 +121,16 @@ Each row shows the prompt, the 3D scene built from it, and the video generated f
     <th width="36%" align="center">3D scene<br><sub>generated by 3D Builder</sub></th>
     <th width="36%" align="center">Generated video<br><sub>rendered by Topview.ai</sub></th>
   </tr>
+  <tr>
+    <td valign="top"><b>Reference image:</b><br><img src="docs/assets/examples/roadside-repair-input.jpg" alt="Reference image: roadside car repair" width="100%"><br><b>Prompt:</b> Build the 3D scene from the reference image.<br>0–3s: Pull back from the leaning man to show both men and the car.<br>3–5s: Over-the-shoulder push-in to the engine.<br>5–7s: Fixed first-person shot of the engine.</td>
+    <td align="center"><video src="https://github.com/user-attachments/assets/26108771-b47f-4e14-ac65-605329030369" width="100%" controls muted playsinline></video></td>
+    <td align="center"><video src="https://github.com/user-attachments/assets/78aaa908-a3bf-4d4e-a0a3-172aa460c76d" width="100%" controls muted playsinline></video></td>
+  </tr>
+  <tr>
+    <td valign="top"><b>Reference image:</b><br><img src="docs/assets/examples/cafe-tablet-input.jpg" alt="Reference image: man reading a tablet in a café" width="100%"><br><b>Prompt:</b> Build the 3D scene from the reference image.<br>0–2.5s: Wide shot, slow push-in.<br>2.5–5s: Medium shot, tracking sideways.<br>5–7s: Close-up of him reading.</td>
+    <td align="center"><video src="https://github.com/user-attachments/assets/623c3610-0eb1-4f66-a1bf-ef1b28a2e360" width="100%" controls muted playsinline></video></td>
+    <td align="center"><video src="https://github.com/user-attachments/assets/aca8255e-e22c-4e47-b55a-4cf614d067a2" width="100%" controls muted playsinline></video></td>
+  </tr>
   <tr>
     <td valign="top"><b>Prompt:</b> A person stands beside a sports car in a showroom. In one continuous ten-second shot, the camera moves from a low angle by the front wheel to a frontal view of the person, then rises and moves around to reveal the car from above.</td>
     <td align="center"><video src="https://github.com/user-attachments/assets/a6e689bb-d059-4eec-a06c-94db098796b9" width="100%" controls muted playsinline></video></td>
@@ -232,13 +242,16 @@ Yes. It covers the whole path from an idea, to a 3D scene, to a real animated vi
 | Opus 5.5 | ⭐️⭐️⭐️ | Strong aesthetics, but expensive. |
 | Astra | ⭐️⭐️⭐️ | Strong 3D results and fast generation, but the most expensive. |
 
+## Tutorial
+
+[Build scenes, stage action and move the camera](https://www.topview.ai/academy/spatial-control#3-1-3d-builder-build-scenes-stage-action-and-move-the-camera)
+
 ## Learn more and join in
 
 | | |
 | --- | --- |
 | 🌐 **Topview.ai** | [www.topview.ai](https://www.topview.ai) |
 | 🎬 **3D Builder home** | [www.topview.ai/3d-builder](https://www.topview.ai/3d-builder) |
-| 🎓 **3D Builder tutorial** | [Build scenes, stage action and move the camera](https://www.topview.ai/academy/spatial-control#3-1-3d-builder-build-scenes-stage-action-and-move-the-camera) |
 | 🛠 **CLI reference** | [CLI and project format](https://github.com/topviewai/topview-3d-builder/blob/main/docs/topview-3d-cli.md) |
 | 🐞 **Feedback and bugs** | [GitHub Issues](https://github.com/topviewai/topview-3d-builder/issues) |