Skip to main content
POST
Create Instance

En-têtes

Content-Type
string
requis

Allowed value: application/json.

Authorization
string
requis

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

Corps

application/json
name
string
requis

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

Exemple:

"example-instance"

product_id
string
requis

Product ID.

Exemple:

"product-id"

image
string
requis

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

Exemple:

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

billing
object
requis

Billing configuration.

resource
object
requis

Resource configuration.

type
enum<string>

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

Options disponibles:
gpu,
cpu
registry_auth_id
string

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

Exemple:

"registry-auth-id"

entrypoint
string

Container entrypoint.

Exemple:

""

command
string

Container startup command.

Exemple:

""

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.

Exemple:
tools
object

Instance tool configuration. Currently only Jupyter is supported.

auto_migrate
object

Auto-migrate configuration.

Réponse

200 - application/json

OK

id
string

ID of the created instance

Exemple:

"ca338f12f3"

Dernière modification le 10 août 2026