Vast.ai API
Instances

launch instance

1min
PUT
https://console.vast.ai/api/v0/launch_instance/
Production server

This endpoint launches an instance based on the specified parameters, selecting the first available offer that meets the criteria.

CLI Usage: vast-ai launch instance {parameters}

Authentication
BearerAuth
Body Parameters
body
*
num_gpus
*
gpu_name
*
region
*
image
*
disk
*
env
args
Responses
200
Instance launched successfully.
success
new_contract
400
Bad request due to invalid input.
success
error
msg
404
No offers found or offer not found.
success
error
msg
default
Unexpected error.
success
error
msg




Updated 06 Feb 2025
Did this page help you?