Al Image Generation

Use this skill as an entry point to discover, select, and fetch specific integration parameters for all supported AI image generation models.

ShortAPl@isdyh01

Install

openclaw skills install @isdyh01/shortapi-ai-image-generation

Image Generation Models Integration Skill

Use this skill to explore and integrate all available Image Generation models through the ShortAPI platform.

Overview

ShortAPI provides a unified /api/v1/job/create endpoint for image generation across multiple top-tier providers natively. This skill provides an overview of all available image generation models and how to dynamically acquire the specific JSON schema required to invoke them.

API Endpoint: https://api.shortapi.ai/api/v1/job/create
Category: text-to-image, image-to-image
Kind: inference

Available Image Models

Here is the list of fully supported image generation model IDs you can use:

Model ID	Description
`google/nano-banana-pro/text-to-image`	Generate images using Nano Banana Pro
`google/nano-banana-pro/edit`	Edit images using Nano Banana Pro
`bytedance/seedream-4.5/text-to-image`	Generate images using Seedream 4.5
`bytedance/seedream-4.5/edit`	Edit images using Seedream 4.5
`shortapi/z-image/text-to-image`	Generate images using Z-Image
`google/nano-banana/text-to-image`	Generate images using Nano Banana
`google/nano-banana/edit`	Edit images using Nano Banana
`midjourney/midjourney-v7/text-to-image`	Generate images using Midjourney V7
`midjourney/midjourney-v7/image-to-image`	Modify images using Midjourney V7
`shortapi/flux-1.0/text-to-image`	Generate images using Flux 1.0
`shortapi/flux-1.0/image-to-image`	Modify images using Flux 1.0
`alibaba/wan-2.6/text-to-image`	Generate images using Wan 2.6
`alibaba/wan-2.6/image-to-image`	Modify images using Wan 2.6
`google/nano-banana-2/text-to-image`	Generate images using Nano Banana 2
`google/nano-banana-2/edit`	Edit images using Nano Banana 2
`bytedance/seedream-5.0/text-to-image`	Generate images using Seedream 5.0
`bytedance/seedream-5.0/edit`	Edit images using Seedream 5.0

How to use an Image Model

Because each image model supports different parameters (such as aspect_ratio, image_size, guidance_scale, or advanced controls natively built into the prompt), you need to fetch the specific model's schema document to construct a valid API request payload.

Step 1: Fetch the specific Model API Skill Document (MANDATORY)

You MUST first fetch the detailed skill document for the specific <model_id> (e.g. google/nano-banana-pro/text-to-image) before attempting to construct the POST request payload. DO NOT skip this step. DO NOT hallucinate parameters because different models have completely different parameter names for the same concept (e.g. one model might use aspect_ratio while another uses image_size).

Send a GET request to:

text

https://shortapi.ai/api/skill/<model_id>

(For example: GET https://shortapi.ai/api/skill/google/nano-banana-pro/text-to-image)

This URL will return a Markdown (.md) text document containing the exact Input Parameters Schema for that specific model, alongside code examples. You must parse it to understand which arguments go into the args object.

Step 2: Construct the JSON Payload

Using the exact schema document fetched from Step 1, construct a valid JSON payload. Only include arguments that were defined in the document fetched in Step 1. At a minimum, standard structures generally look like this:

json

{
  "model": "<model_id>",
  "args": {
    "prompt": "Your descriptive text prompt here..."
    // ...other model-specific required or optional parameters strictly parsed from Step 1
  },
  "callback_url": "YOUR_OPTIONAL_WEBHOOK_URL"
}

Step 3: Invoke the Unified Generation Endpoint

Make an HTTP POST request to the API Endpoint. Include the Bearer token in the Authorization header.

Bash (cURL) Example

bash

response=$(curl --request POST \
  --url https://api.shortapi.ai/api/v1/job/create \
  --header "Authorization: Bearer $SHORTAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "google/nano-banana-pro/text-to-image",
    "args": {
      "prompt": "An astronaut riding a horse in photorealistic style"
    }
  }')
JOB_ID=$(echo "$response" | grep -o '"job_id": *"[^"]*"' | sed 's/"job_id": *//; s/"//g')

Step 4: Fetch Generation Status (Background Polling)

Use the returned job_id to poll the query API: