---
title: ViT Age Classifier | Runware Docs
url: https://runware.ai/docs/models/vit-age-classifier
description: Vision transformer model for estimating age from facial images
---
# ViT Age Classifier

![ViT Age Classifier](https://assets.runware.ai/covers/vit-age-classifier.jpg)

ViT Age Classifier is an image classification model that predicts the age category of a person based on a facial image. It uses a Vision Transformer architecture fine-tuned for age estimation to analyze facial features and output structured age predictions.

- **Status**: live
- **ID**: `vit-age-classifier`
- Try in Playground
- **Release Date**: July 28, 2024
- **Zero Data Retention**: Yes
- **Capabilities**: Image to Text, Age Classification, Checkpoint

## Pricing

$0.0015 from, per run · ~3s per request

**Measured runs**

- 1024×1024 input: `$0.0015` (~2s)

**4 example generations**

- [caption](https://runware.ai/docs/models/vit-age-classifier/examples#example-museum-visitor-age-segment-audit): `$0.0006` (~4s)
- [caption](https://runware.ai/docs/models/vit-age-classifier/examples#example-oral-history-age-cohort-tag): `$0.0006` (~3s)
- [caption](https://runware.ai/docs/models/vit-age-classifier/examples#example-stock-portrait-age-metadata-tag): `$0.0006` (~3s)
- [caption](https://runware.ai/docs/models/vit-age-classifier/examples#example-documentary-casting-age-cohort-check): `$0.0006` (~4s)

billed by compute time, so a request costs what it took · times vary, measured end to end · [How pricing works](https://runware.ai/docs/models-api/pricing)

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

### [taskType](https://runware.ai/docs/models/vit-age-classifier#request-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `caption`

Identifier for the type of task being performed.

### [taskUUID](https://runware.ai/docs/models/vit-age-classifier#request-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.

### [webhookURL](https://runware.ai/docs/models/vit-age-classifier#request-webhookurl)

- **Type**: `string`
- **Format**: `uri`

Webhook URL that receives JSON responses via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.

**Learn more** (1 resource):

- [Webhooks](https://runware.ai/docs/models-api/webhooks) (platform)

### [deliveryMethod](https://runware.ai/docs/models/vit-age-classifier#request-deliverymethod)

- **Type**: `string`
- **Default**: `sync`

Determines how the API delivers task results.

**Allowed values**:

- `sync` Returns results directly in the API response. Over HTTP, a task still running after 120 seconds continues as an async task and comes back with status 'processing'. Poll for its results using getResponse.
- `async` Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse.

**Learn more** (1 resource):

- [Task Polling](https://runware.ai/docs/models-api/task-polling) (platform)

### [includeCost](https://runware.ai/docs/models/vit-age-classifier#request-includecost)

- **Type**: `boolean`

Include task cost in the response.

**Inputs**

Input resources for the task (images, audio, etc). These must be nested inside the \`inputs\` object.

### [image](https://runware.ai/docs/models/vit-age-classifier#request-inputs-image)

- **Path**: `inputs.image`
- **Type**: `string`
- **Required**: true

Image input (UUID, URL, Data URI, or Base64).

**Core Parameters**

Primary parameters that define the task output.

### [model](https://runware.ai/docs/models/vit-age-classifier#request-model)

- **Type**: `string`
- **Required**: true
- **Value**: `vit-age-classifier`

Send `auto` instead of an AIR identifier to have the model router choose the model for this task. The rest of the request is unchanged, every value you send is kept, and only the parameters you leave out are filled in. See [Model Router](https://runware.ai/docs/models-api/model-router).

**Learn more** (3 resources):

- [Text To Image: Model Selection](https://runware.ai/docs/learn/text-to-image#model-selection) (learn)
- [Image Inpainting: Model Specialized Inpainting Models](https://runware.ai/docs/learn/image-inpainting#model-specialized-inpainting-models) (learn)
- [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/learn/image-outpainting#other-critical-parameters) (learn)

## Response Parameters

### [taskType](https://runware.ai/docs/models/vit-age-classifier#response-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `caption`

Identifier for the type of task this response belongs to.

### [taskUUID](https://runware.ai/docs/models/vit-age-classifier#response-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier echoed from the original request, used to match async responses to their tasks.

### [cost](https://runware.ai/docs/models/vit-age-classifier#response-cost)

- **Type**: `float`

Task cost in USD. Present when `includeCost` is set to `true` in the request.

### [structuredData](https://runware.ai/docs/models/vit-age-classifier#response-structureddata)

- **Path**: `structuredData.ageGroup`
- **Type**: `object (2 properties)`
- **Required**: true

Machine-readable age classification data.

#### [ageGroup](https://runware.ai/docs/models/vit-age-classifier#response-structureddata-agegroup)

- **Path**: `structuredData.ageGroup`
- **Type**: `string`
- **Required**: true

Predicted age range of the subject (e.g. `13-20`).

#### [confidence](https://runware.ai/docs/models/vit-age-classifier#response-structureddata-confidence)

- **Path**: `structuredData.confidence`
- **Type**: `float`
- **Required**: true
- **Min**: `0`
- **Max**: `100`

Confidence score as a percentage.

## Examples

### caption (caption)

```
{
  "taskType": "imageCaption",
  "taskUUID": "c2a86bf1-0ef1-416a-8b69-ac4c96242da9",
  "cost": 0.0006,
  "structuredData": {
    "ageGroup": "60-69",
    "confidence": 0.561
  }
}
```

```json
{
  "taskType": "caption",
  "taskUUID": "c2a86bf1-0ef1-416a-8b69-ac4c96242da9",
  "model": "runware:153@1",
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/95238017-bcd7-4c3a-9188-bc5e10e4a1ef.jpg"
  }
}
```

---

### caption (caption)

```
{
  "taskType": "imageCaption",
  "taskUUID": "b4b675b8-a2c4-4b98-acdf-9d323beee101",
  "cost": 0.0006,
  "structuredData": {
    "ageGroup": "60-69",
    "confidence": 0.6245
  }
}
```

```json
{
  "taskType": "caption",
  "taskUUID": "b4b675b8-a2c4-4b98-acdf-9d323beee101",
  "model": "runware:153@1",
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/93389581-decc-4991-beb9-6f75fee36e0a.jpg"
  }
}
```

---

### caption (caption)

```
{
  "taskType": "imageCaption",
  "taskUUID": "b0d77c3c-6b8d-4381-bd98-a69c283c71cb",
  "cost": 0.0006,
  "structuredData": {
    "ageGroup": "60-69",
    "confidence": 0.6069
  }
}
```

```json
{
  "taskType": "caption",
  "taskUUID": "b0d77c3c-6b8d-4381-bd98-a69c283c71cb",
  "model": "runware:153@1",
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/fc0e4ac4-e0ba-49b8-93a3-0a5a3fc14b5b.jpg"
  }
}
```

---

### caption (caption)

```
{
  "taskType": "imageCaption",
  "taskUUID": "138713ee-4605-4ed3-ba89-da1df2ff1a73",
  "cost": 0.0006,
  "structuredData": {
    "ageGroup": "50-59",
    "confidence": 0.5337
  }
}
```

```json
{
  "taskType": "caption",
  "taskUUID": "138713ee-4605-4ed3-ba89-da1df2ff1a73",
  "model": "runware:153@1",
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/b66f0c56-41d0-4240-ad5f-a8a5b0adf604.jpg"
  }
}
```