a2e.ai — Full Platform Skill#

Complete API access to a2e.ai. A2E-eigene Modelle sind kostenlos für max-user. Premium-Modelle (Wan 2.6, Kling 3.0, Seedance 1.5 Pro etc. — erkennbar am 🔥) kosten Coins.

Auth#

bash

source ~/.openclaw/workspace/.env  # loads A2E_KEY

If key expired → Daniel generates new one at https://video.a2e.ai → Account Settings → API Keys

Base URL: https://video.a2e.ai Auth header: Authorization: Bearer $A2E_KEY

Quick CLI — a2e.sh#

bash

{baseDir}/scripts/a2e.sh balance                            # Check coins
{baseDir}/scripts/a2e.sh generate "prompt" [WxH] [style]   # Text2Image (general|manga)
{baseDir}/scripts/a2e.sh nano "prompt" [image_url]          # NanoBanana/Gemini
{baseDir}/scripts/a2e.sh faceswap <face_url> <target_url>   # Face Swap
{baseDir}/scripts/a2e.sh headswap <head_url> <target_url>   # Head Swap
{baseDir}/scripts/a2e.sh img2vid <image_url> "prompt"       # Image to Video
{baseDir}/scripts/a2e.sh vid2vid <image_url> <video_url> "prompt"  # Video to Video
{baseDir}/scripts/a2e.sh tts "text" [voice_id]              # Text to Speech
{baseDir}/scripts/a2e.sh voices                             # List TTS voices
{baseDir}/scripts/a2e.sh voiceclone "name" <audio_url>      # Clone a voice
{baseDir}/scripts/a2e.sh avatar <anchor_id> <audio_url>     # AI Avatar video
{baseDir}/scripts/a2e.sh avatars                            # List available avatars
{baseDir}/scripts/a2e.sh talkphoto <image_url> <audio_url>  # Talking Photo
{baseDir}/scripts/a2e.sh talkvideo <video_url> <audio_url>  # Talking Video
{baseDir}/scripts/a2e.sh dub <video_url> <target_lang>      # AI Dubbing
{baseDir}/scripts/a2e.sh caption <video_url>                # Remove captions
{baseDir}/scripts/a2e.sh tryon <person> <mask> <cloth> <cloth_mask>  # Virtual Try-On
{baseDir}/scripts/a2e.sh createavatar "name" <url> [type]   # Create custom avatar (video|image)
{baseDir}/scripts/a2e.sh trainlipsync <avatar_id>           # Train Studio lip-sync on avatar
{baseDir}/scripts/a2e.sh cloneavatarvoice <avatar_id>       # Clone voice from avatar video
{baseDir}/scripts/a2e.sh myavatars                          # List custom avatars
{baseDir}/scripts/a2e.sh removeavatar <avatar_id>           # Delete custom avatar
{baseDir}/scripts/a2e.sh addface <face_image_url>           # Save face for reuse
{baseDir}/scripts/a2e.sh myfaces                            # List saved faces
{baseDir}/scripts/a2e.sh facepreview <face> <target>        # Quick face swap preview
{baseDir}/scripts/a2e.sh backgrounds                        # List avatar backgrounds
{baseDir}/scripts/a2e.sh addbg <image_url>                  # Add custom background
{baseDir}/scripts/a2e.sh upload <url>                       # Save URL to a2e storage
{baseDir}/scripts/a2e.sh presign                            # Get presigned upload URL
{baseDir}/scripts/a2e.sh languages                          # List available languages
{baseDir}/scripts/a2e.sh status <id> <engine>               # Check task status
{baseDir}/scripts/a2e.sh poll <id> <engine>                 # Poll until done

Available Engines (engine names for status/poll)#

EngineCLI nameEndpoint prefixText2Imaget2iuserText2imageNanoBananananouserNanoBananaFace SwapfaceswapuserFaceSwapTaskHead Swapheadswap(TBD)Image to Videoimg2viduserImage2VideoVideo to Videovid2vidmotionTransferAvatar VideoavatarvideoTalking PhototalkphototalkingPhotoTalking VideotalkvideotalkingVideoAI DubbingdubuserDubbingCaption RemovalcaptionuserCaptionRemovalVirtual Try-OntryonvirtualTryOnVoice ClonevoicecloneuserVoice

Common Async Pattern#

All tasks follow the same flow:

1. POST .../start → get _id + current_status: "initialized"
2. Poll via GET .../{_id} or .../allRecords until completed
3. Status: initialized → processing → completed | failed
4. Result URLs (image_urls, result_url, video_url) expire after ~3 days
5. On failure: check failed_message + failed_code

Known Quirks#

• NanoBanana GET by _id returns 404 → use allRecords to find tasks
• Text2Image input_images does NOT work → use NanoBanana for reference images
• German text in Text2Image often has typos → NanoBanana (Gemini) handles it correctly
• Result URLs are signed and expire after ~3 days → download/save promptly

Additional Models (Web UI, API endpoints unconfirmed)#

These are available on the platform but may not have documented API endpoints yet:

• Kling 3.0 — Cinema-grade video (text/image/motion modes, sound gen)
• Wan 2.6 — Cinematic video with synced audio
• Sora 2 Pro — OpenAI video model
• Seedance 1.5 Pro — Multi-shot video
• Veo 3.1 — Google video generation
• GPT Image 1.5 — OpenAI image model
• Flux 2 Pro — Black Forest Labs, speed-optimized
• Grok Imagine — xAI image/video
• Nano Banana 2 — Next-gen NanoBanana
• Photobook — Multiple portraits from one photo (relevant for AI Photoshooting DAN-102)

Full API Reference#

See {baseDir}/references/api-complete.md for all endpoints with request/response details.