# transform-describe-image-with-transloadit

Generates alt text, title, caption and description for a local image as JSON, or object labels for it, using the Transloadit CLI.

Skill by Transloadit. Category: Documents.

## Install

Project (for this project only):

```sh
npx skills add transloadit/skills --skill transform-describe-image-with-transloadit
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add transloadit/skills --skill transform-describe-image-with-transloadit -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Pass
- ZeroLeaks: Pass

Installs: 78. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/transloadit/skills/transform-describe-image-with-transloadit)

## Source

[Open the source](https://github.com/transloadit/skills/tree/HEAD/skills/transform-describe-image-with-transloadit). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: transform-describe-image-with-transloadit
description: One-off image description using the official `@transloadit/node` CLI. Use `image describe --fields labels` for object-style labels, or `image describe --for wordpress` for structured alt text, title, caption, and description JSON.
---

# Inputs

- Absolute path to a local input image
- Optional `.json` output path; default is the same path with `.json`

# Prepare

Resolve credentials in this order:
- Shell environment variables
- The current working directory `.env` only
- `~/.transloadit/credentials`

If your `.env` lives in a parent directory, export the variables into the shell first.

# Run

Use the official Transloadit Node CLI directly.

Labels / object-style description:

```bash
npx -y @transloadit/node image describe \
  --input ./input.jpg \
  --fields labels \
  --output ./labels.json
```

WordPress-ready fields:

```bash
npx -y @transloadit/node image describe \
  --input ./input.jpg \
  --for wordpress \
  --output ./fields.json
```

Custom field selection:

```bash
npx -y @transloadit/node image describe \
  --input ./input.jpg \
  --fields altText,title,caption,description \
  --output ./fields.json
```

If you omit `--output`, the CLI writes the JSON file next to the input image using the same base
name. After the command finishes, confirm the JSON file exists at the expected output path.

# Output Shapes

`--fields labels` returns a JSON array of labels.

`--for wordpress` and authored `--fields ...` return a JSON object with requested string fields, for example:

```json
{
  "altText": "...",
  "title": "...",
  "caption": "...",
  "description": "..."
}
```

# Notes

- Prefer `--for wordpress` when you want publishable CMS fields.
- Prefer `--fields labels` when you want recognizer-style tags instead of authored copy.
- `--model` only matters for authored fields, not for `labels`.
- Prefer `~/.transloadit/credentials` as the default fallback when you want a reusable user-level setup.
- A current-directory `.env` still takes precedence, so avoid it when deterministic account selection matters.
- If credentials only exist in a repo-root `.env`, run the command from that directory or export the variables first.

# Debug If It Fails

```bash
npx -y @transloadit/node assemblies get <assemblyIdOrUrl> -j
```
````

- Previous: [transform-remove-background-with-transloadit](https://syn4pse.dev/terminal/transloadit-transform-remove-background-with-transloadit.md)
- Next: [statsig-create-cloud-metric](https://syn4pse.dev/terminal/statsig-create-cloud-metric.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
