Skip to main content
POST
Create Instance

Cabeçalhos

Content-Type
string
obrigatório

Allowed value: application/json.

Authorization
string
obrigatório

Bearer authentication format, e.g.: Bearer {{API_KEY}}.

Corpo

application/json
name
string
obrigatório

Instance name. String, length: 1-255 characters.

Exemplo:

"example-instance"

product_id
string
obrigatório

Product ID.

Exemplo:

"product-id"

image
string
obrigatório

Image address. String, length: 1-500 characters.

Exemplo:

"registry.example.com/namespace/image:tag"

billing
object
obrigatório

Billing configuration.

resource
object
obrigatório

Resource configuration.

type
enum<string>

Instance type. Allowed values: gpu, cpu. Default: gpu.

Opções disponíveis:
gpu,
cpu
registry_auth_id
string

Saved registry authentication ID. String, length: 0-255 characters.

Exemplo:

"registry-auth-id"

entrypoint
string

Container entrypoint.

Exemplo:

""

command
string

Container startup command.

Exemplo:

""

envs
object[]

Environment variable list.

ports
object[]

Exposed port list.

network
object

VPC network configuration.

volumes
object[]

Data disk / network storage mounts.

candidate_regions
string[]

Candidate regions for scheduling. The instance is finally scheduled to one of them.

Exemplo:
tools
object

Instance tool configuration. Currently only Jupyter is supported.

auto_migrate
object

Auto-migrate configuration.

Resposta

200 - application/json

OK

id
string

ID of the created instance

Exemplo:

"ca338f12f3"

Última modificação em 10 de agosto de 2026