Skip to main content

3D API

spicyapi/3d-to-video-v1/video-edit

3D to Video renders a grey 3D layout clip as a finished shot: the camera move, timing and placement follow the layout, the look follows your restyled first frame.

From $0.048/s

Workbench

Input

Video editing
142/2000
One or two sentences describing the finished shot, consistent with the look image. Leave out clay, 3D or layout. No effect on price. at least 1 characters · at most 2000 characters
1/1

Drop a video here, or browse · 1 file · Max 90 MB · MP4 · WEBM

  • 1
1 / 1 files
The layout: a grey or clay render of your 3D scene, MP4 or WebM, up to 120 seconds; 24 fps works best. It sets camera, motion, timing and aspect ratio. at least 1 characters
1/1

Drop files or media links, paste, or browse · 1 file · Max 10 MB · JPG · PNG · WEBP

  • 1
1 / 1 files
The look: the layout's first frame restyled with an image model (colour, light, materials, setting). Do not send the grey frame itself. at least 1 characters
0/1

Drop files or media links, paste, or browse · 1 file · Max 10 MB · JPG · PNG · WEBP

0 / 1 files
Optional. The layout's last frame restyled in the same style, to keep the look steady in shots longer than about three seconds. No effect on price. at least 1 characters
affects price
720p or 1080p (default). The layout's aspect ratio is kept. Sets the per-second rate.
Seed
Optional integer to repeat a result. No effect on price. no lower than 0 · no higher than 2147483647
Safety checkerOff

SpicyAPI does not run a safety checker on this model. Your prompt and media go to the model as written, and the model itself decides what comes back.

Checking your account before enabling submission and pricing.

Output

Ready for a new run

Related models and next tasks

Missing the model you need?

3D TO VIDEO API

Block the shot in grey 3D, paint one frame, and get the finished clip with your exact camera move.

Key numbers

Layout length
2 min
Up to 120 seconds of layout video per run; at least 3 seconds are billed.
Timing kept
1:1
Our 3-second and 4-second layouts came back exactly 3.0 and 4.0 seconds long at 24 fps.
Observed wait
40–60 s
Three test clips of 3 to 4 seconds took 40 to 60 seconds including queue time.

Before you spend

Video editing
  • The look image has to be prepared by you: restyle the first frame of the layout with an image model. A grey frame as the look image gives a grey result.
  • The clip has no sound and keeps the layout's aspect ratio. Layout videos longer than 120 seconds are rejected; split long sequences into shots.

What it does

Layout test

Same walk, same orbit, new world

We rendered our animated toy astronaut as a 3-second grey clay clip with a slow orbiting camera, then restyled its first frame as a Martian plain at golden hour. The 720p result kept the stride, the camera arc and the framing frame by frame, and painted dusty red ground, warm rim light and long shadows around it.

Last-frame look

Anchoring both ends of a longer shot

For a 4-second version we also restyled the final layout frame and sent it as last_image_url. Both ends of the clip matched their look images, and the suit stayed white with orange trim throughout. The 1080p run of the 3-second layout returned 1920×1080 in 40 seconds.

Made with 3D

  • 4s
  • 3s
  • 4s
  • 3s

Where it fits

  • Previs that becomes the final shot

    Block a character walk and a camera orbit with simple grey models, restyle one frame in the look of your project, and get a polished clip whose framing matches the plan instead of a random generation.

  • Product and game trailers from existing 3D

    Render an animated product, vehicle or game character as a plain preview, then produce styled versions for different settings by swapping only the look image and the sentence.

Model reference

3D API reference

How to call the 3D API

  1. Render the layout

    Export the camera move and animation as a plain grey video, ideally 24 fps, up to 120 seconds, in MP4 or WebM, and send it as `video_url`. Any 3D tool works; we rendered ours from a GLB in a browser.

  2. Make the look image

    Take the first frame of that layout and restyle it with any image model: palette, lighting, materials, background. Send it as `image_url`. For longer shots, restyle the last frame the same way and send it as `last_image_url`.

  3. Describe and render

    Write one or two sentences about the finished scene in `prompt`, matching the look image, without mentioning clay or 3D. Choose `720p` or `1080p` in `resolution`; set `seed` to repeat a result.

The short version

Animate it in 3D, decide the look on one frame, and let the clip follow your layout.

3D API questions