APIXO standardizes parameters across all models within each category. Switch from Flux 2 to Midjourney with minimal code changes — learn once, use everywhere.
Request Structure All generation models follow the same request structure:
{ "provider" : "auto" , "request_type" : "async" , "callback_url" : "https://your-server.com/callback" , "input" : { "mode" : "text-to-image" , "prompt" : "your description" } }
Top-Level Parameters Routing strategy. Options: auto (best balance), value (cost-optimized), official (direct provider).
How to receive results. async for polling, callback for webhook delivery.
Webhook URL for receiving results. Required when request_type is callback. Must be a publicly accessible HTTPS endpoint.
Model-specific generation parameters. Structure varies by model category (image, video, audio).
Image Generation Parameters All image models (Flux 2, Midjourney, GPT Image 1, etc.) share these input parameters:
mode
string
default: "text-to-image"
required
Generation mode: text-to-image or image-to-image.
Text description of the desired output. 1–5000 characters.
Elements to avoid in the generated image (e.g., "blurry, low quality").
Reference image URLs for image-to-image mode. Max 5 images, each under 10 MB.
Output aspect ratio: 1:1, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, 9:16, 16:9, 21:9, or auto.
Output resolution: 1K, 2K, or 4K.
Output format: png (lossless, larger) or jpeg (compressed, smaller).
Video Generation Parameters All video models (Sora 2, Kling, Veo, etc.) share these input parameters:
mode
string
default: "text-to-video"
required
Generation mode: text-to-video or image-to-video.
Text description of the desired video content.
Elements to avoid in the generated video (e.g., "shaky, low quality").
Reference image URLs for image-to-video mode.
Output aspect ratio: 1:1, 16:9, or 9:16.
Output resolution: 480p, 720p, or 1080p.
Whether to generate audio alongside the video.
Audio Generation Parameters Audio models (Suno) use these input parameters:
Suno version: V4, V4_5, V4_5PLUS, or V5.
Lyrics or a description of the desired music.
Enable custom mode for full control over style and lyrics.
Generate instrumental only (no vocals).
Aspect Ratio Reference Value Description Best For 1:1Square Social media, avatars 16:9Widescreen Video, desktop wallpapers 9:16Vertical Mobile, short videos 4:3Classic Traditional photos 3:4Portrait Classic portraits 21:9Ultra-wide Cinematic, banners
Quick Reference { "provider" : "auto" , "request_type" : "async" , "input" : { "mode" : "text-to-image" , "prompt" : "a serene mountain landscape at sunset" , "aspect_ratio" : "16:9" , "resolution" : "2K" } }
{ "provider" : "auto" , "request_type" : "callback" , "callback_url" : "https://your-server.com/callback" , "input" : { "mode" : "text-to-video" , "prompt" : "a drone shot flying over mountains" , "aspect_ratio" : "16:9" , "duration" : 10 } }
{ "provider" : "auto" , "request_type" : "async" , "input" : { "mode" : "V4_5PLUS" , "prompt" : "upbeat pop song about summer" , "customMode" : false , "instrumental" : false } }
Some models have additional unique parameters for advanced features. See individual model documentation for details.