# picture

> Reference for the picture tool of AI Pics: generate, runs, list, read, delete, usage and providers, with every action.

Source: https://aipics.geenius.io/docs/reference/picture/

AI pictures in a workspace. A run you queue through the door is made as soon as somebody in that workspace has AI Pics open, because the Preview provider runs in a browser. Server providers run on their own once their keys are set.

Call it as `geenius_geeniuspics(tool: "picture", action: "<action>", args: {...})` through Geenius OS.

## Actions

| Action | What it does |
|---|---|
| `generate` | Queues a run: a prompt, an aspect ratio (default 1:1), a count of 1 to 4, a seed, a negative prompt, a provider (default the Preview), a picture to start from with a strength, or variations of a picture. Answers the run's id. Premium and Max only. |
| `runs` | The latest runs with their state (queued, running, done or failed) and pictures. |
| `read` | One picture with its file address. |
| `list` | Pictures: words in the prompt, a collection, favourites, a limit. |
| `delete` | A run and its pictures for good; confirm with the run id. |
| `usage` | Pictures made this month against the plan. |
| `providers` | The models, what each can do and whether it is ready here. |

> [!TIP]
> Ask for the exact arguments of any action with `action: "help", of: "generate"`. The server answers from its own definitions, so that answer is always current.

> [!NOTE]
> Making pictures is the AI feature: Premium and Max only. Pro keeps the library.