Instructions to use MATLOWAI/MiniMax-H3-ORB360-CardSpin with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Inference
- Notebooks
- Google Colab
- Kaggle
Note: camera-height prompts do not hold on real photos yet; follow-up training in progress
Browse files
README.md
CHANGED
|
@@ -144,7 +144,8 @@ For the card spin, use `minimax_h3_orb360_cardspin_v2_step50.safetensors` and `p
|
|
| 144 |
1500 was trained on, taken from two of our held-out tests (an orbit from 30 degrees below with no floor, and front
|
| 145 |
and back pictures taken from 45 degrees with the orbit at 5 degrees). The numbers in them (camera distance, how
|
| 146 |
much of the frame the subject fills) describe those test objects; edit the heights, times and angles for your own
|
| 147 |
-
use.
|
|
|
|
| 148 |
- `cardspin_caption.txt`: the card spin.
|
| 149 |
- Resolutions we have seen work: 800 x 800, 1024 x 768 and 1152 x 768 landscapes, 672 x 832 and 832 x 1024
|
| 150 |
portraits.
|
|
@@ -157,6 +158,9 @@ For the card spin, use `minimax_h3_orb360_cardspin_v2_step50.safetensors` and `p
|
|
| 157 |
Tested on three objects that were never rendered for training (a vintage film camera, a stylised character and a
|
| 158 |
stone cat statue), one seed per test, against Blender renders of the true orbit:
|
| 159 |
|
|
|
|
|
|
|
|
|
|
| 160 |
| Test | Result |
|
| 161 |
|---|---|
|
| 162 |
| Orbit at 20 degrees, 3 views (0/120/240) | Within one frame (2.9 degrees) of the true orbit on every frame |
|
|
@@ -206,6 +210,10 @@ reference pictures at 0, 120 and 240 degrees, 750 steps. Stage 2: the same 50 ca
|
|
| 206 |
some subjects or seeds commit to the card less than others. Both CardSpin files soften the image (table above).
|
| 207 |
- Step 1500 was trained on grey-backdrop renders of 23 objects. It orbits real photos well in our tests, but was
|
| 208 |
evaluated on a handful of images and three held-out objects, one seed each, not a large benchmark.
|
|
|
|
|
|
|
|
|
|
|
|
|
| 209 |
- Big jumps between the pictures' height and the orbit's height, and orbits whose height changes during the clip,
|
| 210 |
do not work yet.
|
| 211 |
- From one picture, the sides the camera has not seen are invented. More pictures (front and back, a turnaround, or
|
|
|
|
| 144 |
1500 was trained on, taken from two of our held-out tests (an orbit from 30 degrees below with no floor, and front
|
| 145 |
and back pictures taken from 45 degrees with the orbit at 5 degrees). The numbers in them (camera distance, how
|
| 146 |
much of the frame the subject fills) describe those test objects; edit the heights, times and angles for your own
|
| 147 |
+
use. **Height prompts are still being trained:** they work on grey-backdrop renders like the ones step 1500 was
|
| 148 |
+
trained on, but on real photos the orbit currently stays at the photo's own height (see Limitations).
|
| 149 |
- `cardspin_caption.txt`: the card spin.
|
| 150 |
- Resolutions we have seen work: 800 x 800, 1024 x 768 and 1152 x 768 landscapes, 672 x 832 and 832 x 1024
|
| 151 |
portraits.
|
|
|
|
| 158 |
Tested on three objects that were never rendered for training (a vintage film camera, a stylised character and a
|
| 159 |
stone cat statue), one seed per test, against Blender renders of the true orbit:
|
| 160 |
|
| 161 |
+
All of these tests use grey-backdrop Blender renders. Height control has not yet carried over to real photos (see
|
| 162 |
+
Limitations).
|
| 163 |
+
|
| 164 |
| Test | Result |
|
| 165 |
|---|---|
|
| 166 |
| Orbit at 20 degrees, 3 views (0/120/240) | Within one frame (2.9 degrees) of the true orbit on every frame |
|
|
|
|
| 210 |
some subjects or seeds commit to the card less than others. Both CardSpin files soften the image (table above).
|
| 211 |
- Step 1500 was trained on grey-backdrop renders of 23 objects. It orbits real photos well in our tests, but was
|
| 212 |
evaluated on a handful of images and three held-out objects, one seed each, not a large benchmark.
|
| 213 |
+
- **Camera-height (angle offset) prompts do not hold on real photos yet.** They work on grey-backdrop renders, but in
|
| 214 |
+
our test an eye-level real photo prompted for an orbit 35 degrees above or 20 degrees below orbited at the photo's
|
| 215 |
+
own height both times. A follow-up run training straight-on references, tilted orbits and vertical loops is in
|
| 216 |
+
progress.
|
| 217 |
- Big jumps between the pictures' height and the orbit's height, and orbits whose height changes during the clip,
|
| 218 |
do not work yet.
|
| 219 |
- From one picture, the sides the camera has not seen are invented. More pictures (front and back, a turnaround, or
|