ai-image:status

Check the generation status of an AI image task by art variation ID.

Type: Synchronous (status check)

Usage

Bash

simplified ai-image:status --id <art-variation-id>

Options

Flag	Type	Required	Description
--id	string	✅	Art variation ID from ai-image:generate response

Example

Bash

simplified ai-image:status --id "av_789"

Response

JSON

{
  "id": "av_789",
  "status": "completed",
  "assets": [
    {
      "asset_id": "asset_abc123",
      "url": "https://cdn.simplified.com/generated.png"
    }
  ]
}

Status Values

Status	Meaning
pending	Generation is queued or in progress
completed	Images are ready — check assets[].url
failed	Generation failed

Polling Pattern

Bash

ART_ID=$(simplified ai-image:generate \
  --model flux.flux-realism \
  --prompt "A mountain sunrise" | jq -r '.art_variation_id')

while true; do
  RESULT=$(simplified ai-image:status --id "$ART_ID")
  STATUS=$(echo "$RESULT" | jq -r '.status')
  if [ "$STATUS" = "completed" ]; then
    echo "$RESULT" | jq -r '.assets[].url'
    break
  elif [ "$STATUS" = "failed" ]; then
    echo "Generation failed" >&2; break
  fi
  sleep 3
done

Tip: Use --wait on ai-image:generate to avoid manual polling.