Skip to main content

Create an instance from a fully specified placement

POST 
/instance

Create an instance from an already computed placement object when you want exact control instead of Skulk picking the placement. Every embedded shard card must identify the same model alias as the assignment and exactly match the effective card already present in the authorized local catalog. A positive contextTokenLimit caps the requested window: admission may lower it for current resources but never raises it. Nonpositive explicit limits are rejected during placement. Master admission requires observed VRAM for concrete GPU shards and accounts for existing placements. Omitted non-RPC backends resolve from node engine telemetry before admission; missing evidence is refused. Text-to-music placements require one specified node; the API prepares audio.cpp there and verifies a ready signed build claim before accepting the command. A refused acknowledged command retains placement_failed evidence in the instance failure history.

Request​

Responses​

Successful Response