# All Images AI

All-Images.ai provides AI-powered image generation, retrieval, and management services, enabling developers to create and manage images through advanced AI capabilities.

- **Category:** artificial intelligence
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 7
- **Triggers:** 0
- **Slug:** `ALL_IMAGES_AI`
- **Version:** 20260316_00

## Tools

### Check API Key

**Slug:** `ALL_IMAGES_AI_CHECK_API_KEY`

Validates the current API key and retrieves associated account information. Returns the email address and optional name associated with the API key. Use this action to verify your API key is valid before making other API calls.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create webhook endpoint

**Slug:** `ALL_IMAGES_AI_CREATE_WEBHOOK_ENDPOINT`

Tool to add a webhook endpoint to an API key. Use when you want to receive print event callbacks at a custom endpoint.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The HTTPS URL to receive webhook callbacks. Endpoint must be idempotent; events may be delivered more than once. |
| `events` | array | No | List of event types to subscribe to. Available events: 'test', 'print.created', 'print.active', 'print.failed', 'print.progress', 'print.completed'. Defaults to ['print.failed', 'print.completed'] if not provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Image Generations

**Slug:** `ALL_IMAGES_AI_DELETE_IMAGE_GENERATIONS`

Tool to delete one or more image generation batches by their print IDs. Use when you need to remove image generations that are no longer needed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `printIds` | array | Yes | List of print IDs to delete. Each ID corresponds to an image generation batch. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Credits Balance

**Slug:** `ALL_IMAGES_AI_GET_CREDITS`

Tool to retrieve the current credits balance for your API key. Use this action to check available credits before making API calls that consume credits.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Webhook

**Slug:** `ALL_IMAGES_AI_GET_WEBHOOK`

Tool to retrieve webhook details by its ID. Use when you need to check the configuration of an existing webhook endpoint, including its URL and subscribed events.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `api_key_webhook_id` | string | Yes | Unique identifier of the webhook to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Automated Images

**Slug:** `ALL_IMAGES_AI_LIST_AUTOMATED_IMAGES`

Tool to list all images generated automatically for bulk use. Use after creating automated-image batches to review and manage them.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag` | string | No | Filter batches by a single tag. |
| `name` | string | No | Filter batches by generation name (partial match). |
| `sort` | string | No | Sort order, e.g., 'createdAt:desc' or 'name:asc'. |
| `limit` | integer | No | Maximum number of batches to return (>=1). |
| `offset` | integer | No | Number of batches to skip (>=0). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Downloaded Images

**Slug:** `ALL_IMAGES_AI_LIST_DOWNLOADED_IMAGES`

Tool to list images that have been downloaded from All-Images.ai. Use this action to retrieve and filter downloaded images with optional date range filtering and pagination support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Sort order for results, e.g., 'downloadedAt:desc' or 'downloadedAt:asc'. |
| `limit` | integer | No | Maximum number of images to return (>=1). |
| `offset` | integer | No | Number of images to skip for pagination (>=0). |
| `afterCreatedAt` | string | No | Filter images downloaded after this date (ISO-8601 format, e.g., '2024-01-01T00:00:00Z'). |
| `beforeCreatedAt` | string | No | Filter images downloaded before this date (ISO-8601 format, e.g., '2024-12-31T23:59:59Z'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |