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.

7installs
Sourceagntswrm/agent-media
Added on

NPX Install

npx skill4agent add agntswrm/agent-media image-generate

Tags

Translated version includes tags in frontmatter
ai-image-generationcommand-line-toolmedia-agentimage-creationai-providers

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

OptionRequiredDescription
--prompt
YesText description of the image to generate
--width
NoWidth of the generated image in pixels (default: 1280)
--height
NoHeight of the generated image in pixels (default: 720)
--count
NoNumber of images to generate (default: 1)
--out
NoOutput path, filename or directory (default: ./)
--provider
NoProvider 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.