Create Compute Instance

Creates a new compute instance with the specified configuration and SSH key.

Requirements:

• Requires compute permissions (extra_permissions.compute = true)
• Authentication required via admin API key
• Valid SSH public key required for instance access

Key Features:

• Create high-performance GPU instances
• Specify sector for InfiniBand configuration (8x H100 only)
• SSH key-based authentication
• Automatic instance provisioning and region assignment
• Idempotent creation with Idempotency-Key header (optional but recommended)

Common Use Cases:

• Spin up compute resources for ML training
• Create GPU instances for inference workloads
• Set up development environments with H100 GPUs
• Deploy distributed training with InfiniBand networking

Instance Types:

• gpu_8x_h100_sxm5: 8x NVIDIA H100 GPUs (high-performance, supports sector configuration for InfiniBand)
• gpu_1x_h100_sxm5: 1x NVIDIA H100 GPU (standard)

Idempotency:

• Optional Idempotency-Key header prevents duplicate instance creation on retries
• Responses cached for 10 minutes per unique key

See fal.ai docs for more details.

{
  "instance_type": "gpu_1x_h100_sxm5",
  "ssh_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQC... user@host",
  "sector": "sector_1"
}

{
  "id": "inst_abc123xyz",
  "instance_type": "gpu_1x_h100_sxm5",
  "region": "us-west",
  "sector": "sector_1",
  "ip": "203.0.113.42",
  "status": "ready",
  "creator_user_nickname": "developer"
}