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

# Image car damage

## Overview

This is an example of how to extract structured data from an image using
Instructor. The image is loaded from a file and converted to base64 format
before sending it to OpenAI API.

In this example we will be extracting structured data from an image of a car
with visible damage. The response model will contain information about the
location of the damage and the type of damage.

## Scanned image

Here's the image we're going to extract data from.

<img src="https://mintcdn.com/cognesy-093fe941/dlz2lUeh9hhvQK0v/images/car-damage.jpg?fit=max&auto=format&n=dlz2lUeh9hhvQK0v&q=85&s=201c1c9699eea1348b1d8f57e6be4667" alt="Car Photo" width="800" height="600" data-path="images/car-damage.jpg" />

## Example

```php theme={null}
<?php
require 'examples/boot.php';

use Cognesy\Addons\Image\Image;
use Cognesy\Instructor\StructuredOutputRuntime;
use Cognesy\Polyglot\Inference\LLMProvider;
use Cognesy\Schema\Attributes\Description;

enum DamageSeverity : string {
    case Minor = 'minor';
    case Moderate = 'moderate';
    case Severe = 'severe';
    case Total = 'total';
}

enum DamageLocation : string {
    case Front = 'front';
    case Rear = 'rear';
    case Left = 'left';
    case Right = 'right';
    case Top = 'top';
    case Bottom = 'bottom';
}

class Damage {
    #[Description('Identify damaged element')]
    public string $element;
    /** @var DamageLocation[] */
    public array $locations;
    public DamageSeverity $severity;
    public string $description;
}

class DamageAssessment {
    public string $make;
    public string $model;
    public string $bodyColor;
    /** @var Damage[] */
    public array $damages = [];
    public string $summary;
}

$assessment = Image::fromFile(__DIR__ . '/car-damage.jpg')
    ->toData(
        responseModel: DamageAssessment::class,
        prompt: 'Identify and assess each car damage location and severity separately.',
        structuredOutput: StructuredOutputRuntime::fromProvider(
            provider: LLMProvider::using('openai'),
        ),
        model: 'gpt-4o-mini',
        options: ['max_tokens' => 4096]
    );

dump($assessment);

assert(strtolower(trim($assessment->make)) === 'toyota');
assert(strtolower(trim($assessment->model)) === 'prius');
assert(strtolower(trim($assessment->bodyColor)) === 'white');
assert(count($assessment->damages) > 0);
assert(trim($assessment->summary) !== '');
?>
```