video-gen/workflow

7 notes, read out of this brain and free to use. Each one was extracted from a source and is re-checked against its exam.

Image-to-video animating logos into game intros

Image-to-video is the main use case for video-gen and animates a still logo or key-art into a game-intro sting. The -i parameter accepts a local file path (automatically converted to base64 data URI) or a public URL. For image-to-video, the aspect ratio is taken from the input image and the aspect field is ignored. sora-2 supports 1 image input, veo3.1 supports up to 3 images. The animation prompt should focus on the logo's movement and atmosphere without requesting additional text to be added to the image.

video-gen Python API example: i2v() for image-to-video

Example showing how to animate a logo PNG into a game-intro sting using the i2v function from the videogen module: import sys sys.path.insert(0, "/Users/egorfedorov/Downloads/GameDev") from videogen import i2v, generate, VideoClient # Animate a logo PNG into a ~5s game-intro sting (medium = sora-2): r = i2v( "the logo holds center frame, subtle metallic glints sweep across " "the letterforms, soft particle shimmer, gentle push-in, then settles; " "clean, premium, no text added, transparent-feeling dark backdrop", image="/abs/path/logo.png", output="/abs/path/intro.mp4", duration=5, # snapped → 4s on sora-2 quality="medium", ) # r returns: {task_id, video_url, thumbnail_url, model, duration, output_path, thumbnail_path} # Premium hero sting at 1080p: i2v(prompt, image=logo, output=out, quality="high", resolution="1080p") # Pure text-to-video: generate("neon city flythrough, cinematic", output=out, duration=8) This example demonstrates the main image-to-video use case with medium quality (sora-2) and also shows how to request premium quality and pure text-to-video generation.

video-gen rendering time and async timeout

sora-2 rendering takes approximately 10 minutes. The VideoClient default budget is timeout=1200s (20 minutes). For long clips or expected slow renders, raise the timeout by passing VideoClient(timeout=...) with a higher value in seconds. Generated video URLs expire after 24 hours, so always pass output= to save the video file immediately rather than relying on the temporary URL.

video-gen important caveats: transparency, text, and cost

Models output opaque MP4 video with no transparency. For overlay stings, generate on a flat dark or black backdrop and then key/blend the video in the game engine, or use it as a full-frame splash video instead. Never ask the model to add text to the video; instead animate the existing logo art and render any titles via the frontend (memory tag: feedback_no_text_in_art). Cost is calculated as model tier × resolution × duration; keep resolution at 720p and duration short unless a splash screen needs higher quality. Check spending at https://apimart.ai/keys.

video-gen thumbnail output

When the apimart.ai API returns a thumbnail, a .thumb.jpg file is automatically saved next to the generated .mp4 file in the same output directory.

video-gen studio asset distribution

Generated game intro videos should be shipped to games/<Game>/static/ or the game's designated asset directory. These videos are played on Boot or splash screens before the RGS handshake.

Video generation polling and timing

Video renders are slow with estimated generation time approximately 600 seconds for sora-2. Poll the task status approximately every 5 seconds. Downloaded video URLs expire after 24 hours and should be downloaded immediately upon completion.

Give your agent this brain