---
title: "Start the auto control by AI"
method: POST
path: "/ai-control/start"
tags: ["control"]
---

# Start the auto control by AI

`POST /ai-control/start`

Start the auto control by AI.

## Request body

- StartAIControlRequest — Request to start the AI control of the robot.
  - `angle_format` 'degrees' | 'rad' | 'other' — Format of the angles used in the model. Can be 'degrees', 'radians', or 'other'. If other is selected, you will need to specify a min and max angle value.
  - `cameras_keys_mapping` object, nullable — Mapping of the camera keys to the camera ids. If set to None, use the default mapping based on cameras order.
  - `checkpoint` integer, nullable — Checkpoint to use for the model. If None, uses the latest checkpoint.
  - `max_angle` number, nullable — If angle_format is 'other', this is the maximum angle value used in the model. If None and angle_format is 'other', will raise an error.
  - `min_angle` number, nullable — If angle_format is 'other', this is the minimum angle value used in the model. If None and angle_format is 'other', will raise an error.
  - `model_id` string, required — Hugging Face model id to use
  - `model_type` 'gr00t' | 'ACT' | 'ACT_BBOX', required — Type of model to use. Can be gr00t or act.
  - `prompt` string, nullable — Prompt to be followed by the robot
  - `robot_serials_to_ignore` string[], nullable — List of robot serial ids to ignore. If set to None, controls all available robots.
  - `selected_camera_id` integer, nullable — Name of the camera to use when ACT_BBOX model is used. This is only required for ACT_BBOX models, and is ignored for other models.
  - `speed` number — Speed of the AI control. 1.0 is normal speed, 0.5 is half speed, 2.0 is double speed. The highest speed is still bottlenecked by the GPU inference time.
  - `verify_cameras` boolean — Whether to verify the setup before starting the AI control. If False, skips the verification step.

## Response `200`

Successful Response

- AIControlStatusResponse — Response when starting the AI control.
  - `ai_control_signal_id` string, required
  - `ai_control_signal_status` 'stopped' | 'running' | 'paused' | 'waiting', required
  - `message` string, nullable
  - `server_info` ServerInfoResponse
    - `model_id` string, required
    - `port` integer, required
    - `server_id` integer, required
    - `tcp_socket` unknown[], required
      - unknown
    - `timeout` integer, required
    - `url` string, required
  - `status` 'ok' | 'error'

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/phospho/apis/fastapi.md) · [All operations](https://skmtc.net/phospho/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/phospho/fastapi/revisions/93e83588fc02/schema)