image-generate

Original：🇺🇸 English

Translated

Generates an image from a text prompt using AI models. Use when you need to create images from descriptions, generate artwork, or produce visual content from text.

2installs

Sourceagntswrm/agent-media

Added on2026-02-07

NPX Install

npx skill4agent add agntswrm/agent-media image-generate

SKILL.md Content

View Translation Comparison →

Image Generate

Generates an image from a text prompt using AI image generation models.

Command

bash

agent-media image generate --prompt <text> [options]

Inputs

Option	Required	Description
`--prompt`	Yes	Text description of the image to generate
`--width`	No	Width of the generated image in pixels (default: 1280)
`--height`	No	Height of the generated image in pixels (default: 720)
`--count`	No	Number of images to generate (default: 1)
`--out`	No	Output path, filename or directory (default: ./)
`--provider`	No	Provider to use (default: auto-detect)

Output

Returns a JSON object with the generated image path:

json

{
  "ok": true,
  "media_type": "image",
  "action": "generate",
  "provider": "fal",
  "output_path": "generated_123_abc.png",
  "mime": "image/png",
  "bytes": 567890
}

Examples

Generate an image:

bash

agent-media image generate --prompt "a red robot standing in a forest"

Generate with specific dimensions:

bash

agent-media image generate --prompt "sunset over mountains" --width 1024 --height 768

Generate using specific provider:

bash

agent-media image generate --prompt "abstract art" --provider replicate

Providers

This action requires an external provider:

fal - Requires
```
FAL_API_KEY
```
replicate - Requires
```
REPLICATE_API_TOKEN
```
runpod - Requires
```
RUNPOD_API_KEY
```
ai-gateway - Requires
```
AI_GATEWAY_API_KEY
```

The local provider does not support image generation.

Image Generate

Generates an image from a text prompt using AI image generation models.

Command

bash

agent-media image generate --prompt <text> [options]

Inputs

Option	Required	Description
`--prompt`	Yes	Text description of the image to generate
`--width`	No	Width of the generated image in pixels (default: 1280)
`--height`	No	Height of the generated image in pixels (default: 720)
`--count`	No	Number of images to generate (default: 1)
`--out`	No	Output path, filename or directory (default: ./)
`--provider`	No	Provider to use (default: auto-detect)

Output

Returns a JSON object with the generated image path:

json

{
  "ok": true,
  "media_type": "image",
  "action": "generate",
  "provider": "fal",
  "output_path": "generated_123_abc.png",
  "mime": "image/png",
  "bytes": 567890
}

Examples

Generate an image:

bash

agent-media image generate --prompt "a red robot standing in a forest"

Generate with specific dimensions:

bash

agent-media image generate --prompt "sunset over mountains" --width 1024 --height 768

Generate using specific provider:

bash

agent-media image generate --prompt "abstract art" --provider replicate

Providers

This action requires an external provider:

fal - Requires
```
FAL_API_KEY
```
replicate - Requires
```
REPLICATE_API_TOKEN
```
runpod - Requires
```
RUNPOD_API_KEY
```
ai-gateway - Requires
```
AI_GATEWAY_API_KEY
```

The local provider does not support image generation.

image-generate

NPX Install

Tags

SKILL.md Content

Image Generate

Command

Inputs

Output

Examples

Providers

image-generate

NPX Install

Tags

SKILL.md Content

Image Generate

Command

Inputs

Output

Examples

Providers