---
title: "Create Instance"
method: POST
path: "/v1/developer/{developer_id}/create-instance"
tags: ["Developer Management"]
---

# Create Instance

`POST /v1/developer/{developer_id}/create-instance`

## Request

- Base URL: `https://api.oneinfer.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.oneinfer.ai/v1/developer/{developer_id}/create-instance`
- Auth: HTTP bearer

## Path parameters

- `developer_id` string, required

## Request body

- CreateInstanceRequest
  - `provider_name` string, required
  - `instance_name` string, required
  - `gpu_id` string, nullable
  - `gpu_num` integer
  - `disk_size` integer
  - `image_url` string, required
  - `ports` union: Ports exposed by the selected catalog or registry image
    - string
    - unknown[]
      - unknown
  - `envs` object[], nullable: Environment variables required by the image
  - `command` string, nullable: Container command or arguments
  - `start_command` string, nullable: Catalog alias for the container command
  - `kind` string, nullable: Novita instance kind
  - `image_source` string, nullable: Image source: catalog or registry
  - `registry_url` string, nullable: Container registry URL or host
  - `registry_image` string, nullable: Full private registry image path
  - `registry_username` string, nullable: Container registry username
  - `registry_password` string, nullable: Container registry password or access token
  - `registry_auth_name` string, nullable: Friendly name for saved registry credentials
  - `registry_credential_id` string, nullable: Saved OneInfer registry credential ID
  - `registry_auth_id` string, nullable: Provider registry auth ID
  - `container_registry_auth_id` string, nullable: Runpod container registry auth ID
  - `region` string, required
  - `startup_script` string, nullable: Startup script to run on instance launch
  - `additional_volume_size` number, nullable: Additional volume size in GB (Verda: volume, Novita AI: network storage)
  - `additional_volume_region` string, nullable: Volume Region
  - `storage` StorageAttachment[], nullable: Persistent storage volumes to attach
    - `storage_id` string, required
    - `mount_path` string, required: Path to mount storage inside container (e.g., /workspace)
    - `read_only` boolean
  - `volume_name` string, nullable: Name of existing volume to attach
  - `volume_region` string, nullable: Region hint for an existing external volume
  - `compute_type` string, nullable: Compute type (e.g. CPU, GPU)
  - `plan_id` string, nullable: Provider plan ID for CPU instances
  - `cpu_flavor_id` string, nullable: CPU flavor ID for CPU instances
  - `is_spot` boolean, nullable: Provision as a spot instance (Verda only). Uses spot pricing for credit checks.

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/oneinfer/apis/oneinfer-apis.md) · [All operations](https://skmtc.dev/oneinfer/apis/oneinfer-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/oneinfer/apis/oneinfer-apis/revisions/a49f22311a8f?raw)