AIMLAPI Media Generation

Overview

Generate images and videos via the AIMLAPI OpenAI-compatible API using reusable scripts that handle auth, payloads, and media downloads.

Quick start

export AIMLAPI_API_KEY="sk-aimlapi-..."
python3 {baseDir}/scripts/gen_image.py --prompt "ultra-detailed studio photo of a lobster astronaut"
python3 {baseDir}/scripts/gen_video.py --prompt "slow drone shot of a foggy forest" --model aimlapi/<provider>/<video-model>

Tasks

Generate images

Use scripts/gen_image.py to call /images/generations and save results locally.

python3 {baseDir}/scripts/gen_image.py \
  --prompt "cozy cabin in a snowy forest" \
  --model aimlapi/openai/gpt-image-1 \
  --size 1024x1024 \
  --count 2 \
  --out-dir ./out/images

Notes:

• •Change --base-url if your AIMLAPI endpoint differs.
• •Use --extra-json to pass provider-specific parameters without editing the script.

Generate videos

Use scripts/gen_video.py to call the video generation endpoint and save the returned media.

python3 {baseDir}/scripts/gen_video.py \
  --prompt "time-lapse of clouds over a mountain range" \
  --model aimlapi/<provider>/<video-model> \
  --endpoint videos/generations \
  --out-dir ./out/videos \
  --extra-json '{"duration": 6, "size": "1024x576"}'

Notes:

• •The video endpoint and payload fields vary by provider. Confirm the correct endpoint and fields in your AIMLAPI model docs and pass them via --endpoint and --extra-json.

References

• •references/aimlapi-media.md: endpoint and payload notes, plus troubleshooting tips.