> ## Documentation Index
> Fetch the complete documentation index at: https://docs.phospho.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Start the auto control by AI

> Start the auto control by AI.



## OpenAPI

````yaml post /ai-control/start
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers: []
security: []
paths:
  /ai-control/start:
    post:
      tags:
        - control
      summary: Start the auto control by AI
      description: Start the auto control by AI.
      operationId: start_ai_control_ai_control_start_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StartAIControlRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AIControlStatusResponse'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
components:
  schemas:
    StartAIControlRequest:
      description: Request to start the AI control of the robot.
      properties:
        angle_format:
          default: rad
          description: >-
            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.
          enum:
            - degrees
            - rad
            - other
          examples:
            - rad
          title: Angle Format
          type: string
        cameras_keys_mapping:
          anyOf:
            - additionalProperties:
                type: integer
              type: object
            - type: 'null'
          description: >-
            Mapping of the camera keys to the camera ids. If set to None, use
            the default mapping based on cameras order.
          examples:
            - context_camera: 1
              wrist_camera: 0
          title: Cameras Keys Mapping
        checkpoint:
          anyOf:
            - type: integer
            - type: 'null'
          description: >-
            Checkpoint to use for the model. If None, uses the latest
            checkpoint.
          examples:
            - 500
          title: Checkpoint
        max_angle:
          anyOf:
            - type: number
            - type: 'null'
          description: >-
            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.
          title: Max Angle
        min_angle:
          anyOf:
            - type: number
            - type: 'null'
          description: >-
            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.
          title: Min Angle
        model_id:
          description: Hugging Face model id to use
          title: Model Id
          type: string
        model_type:
          description: Type of model to use. Can be gr00t or act.
          enum:
            - gr00t
            - ACT
            - ACT_BBOX
          title: Model Type
          type: string
        prompt:
          anyOf:
            - type: string
            - type: 'null'
          description: Prompt to be followed by the robot
          title: Prompt
        robot_serials_to_ignore:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: >-
            List of robot serial ids to ignore. If set to None, controls all
            available robots.
          examples:
            - - /dev/ttyUSB0
          title: Robot Serials To Ignore
        selected_camera_id:
          anyOf:
            - type: integer
            - type: 'null'
          description: >-
            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.
          title: Selected Camera Id
        speed:
          default: 1
          description: >-
            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.
          maximum: 2
          minimum: 0.1
          title: Speed
          type: number
        verify_cameras:
          default: true
          description: >-
            Whether to verify the setup before starting the AI control. If
            False, skips the verification step.
          title: Verify Cameras
          type: boolean
      required:
        - model_id
        - model_type
      title: StartAIControlRequest
      type: object
    AIControlStatusResponse:
      additionalProperties: true
      description: Response when starting the AI control.
      properties:
        ai_control_signal_id:
          title: Ai Control Signal Id
          type: string
        ai_control_signal_status:
          enum:
            - stopped
            - running
            - paused
            - waiting
          title: Ai Control Signal Status
          type: string
        message:
          anyOf:
            - type: string
            - type: 'null'
          title: Message
        server_info:
          anyOf:
            - $ref: '#/components/schemas/ServerInfoResponse'
            - type: 'null'
        status:
          default: ok
          enum:
            - ok
            - error
          title: Status
          type: string
      required:
        - ai_control_signal_id
        - ai_control_signal_status
      title: AIControlStatusResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    ServerInfoResponse:
      properties:
        model_id:
          title: Model Id
          type: string
        port:
          title: Port
          type: integer
        server_id:
          title: Server Id
          type: integer
        tcp_socket:
          maxItems: 2
          minItems: 2
          prefixItems:
            - type: string
            - type: integer
          title: Tcp Socket
          type: array
        timeout:
          title: Timeout
          type: integer
        url:
          title: Url
          type: string
      required:
        - server_id
        - url
        - port
        - tcp_socket
        - model_id
        - timeout
      title: ServerInfoResponse
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object

````