Skip to navigation

Infer

View as Markdown

Request

This endpoint expects an object.
imageslist of stringsRequired

Compressed camera images as base64 strings or data:image/…;base64 URIs, ordered by camera_order and timestep for trajectory modes. When camera_order is omitted for trajectory modes, the legacy 4 camera x 4 frame order is used. Answer-only VQA accepts variable image counts and preserves input order.

modeenumOptionalDefaults to trajectory

Inference mode: trajectory generation, visual question answering, or both.

Allowed values:
camera_orderlist of strings or nullOptional

Optional camera names matching the image camera-major order. Names may use Alpamayo full camera names or OSS short names such as cross_left and front_wide. Required for trajectory modes when image count is not 16.

num_frames_per_cameraintegerOptional>=1Defaults to 4
Number of temporal frames supplied for each camera.
egomotionmap from strings to any or nullOptional

Egomotion payload required for trajectory modes. ego_history_xyz must have shape [16, 3]. ego_history_rot must contain exactly 16 quaternion rows [w, x, y, z] or 16 3x3 rotation matrices. The 16-row history is required even for reduced image layouts.

num_traj_samplesintegerOptional1-32Defaults to 1
Number of trajectory samples to generate.
nav_textstring or nullOptional
Optional navigation instruction for trajectory generation.
questionstring or nullOptional

Question for mode=‘answer’ or mode=‘both’.

temperaturedoubleOptional0-2Defaults to 0.6
VLM sampling temperature.
top_pdoubleOptional0-1Defaults to 0.98

VLM nucleus sampling top-p.

top_kinteger or nullOptional1-2147483647

Optional VLM top-k sampling limit. Use 1 for greedy/top-1 decoding.

max_tokensintegerOptional1-1024Defaults to 256
Maximum VLM generation tokens.
seedinteger or nullOptional0-2147483647

Optional per-request sampling seed. When omitted, the container default seed is used. For repeatable K=1 trajectory inference in the same deployment, use a fixed seed with top_k=1 and top_p=1.

Response

Successful Response
modeenum
Allowed values:
pred_trajectorieslist of any or nullOptional
pred_rotationslist of any or nullOptional
answerstring or nullOptional
reasoning_textstring or nullOptional
num_samplesinteger or nullOptional
num_pointsinteger or nullOptional
durationdouble or nullOptional
inference_timedouble or nullOptional
metricsmap from strings to any or nullOptional

Errors

422
Unprocessable Entity Error