Image Models

List all available image generation models. No payment required.

Endpoint

GET /v1/images/models

Request

Simple GET request with no parameters required:

curl https://api.x-router.ai/v1/images/models

Response

Success Response (200 OK)

{
  total: number;        // Total number of available models
  models: [
    {
      id: string;                 // Model identifier for API requests
      name: string;               // Display name
      description: string;        // Model description and capabilities
      architecture: string;       // Model architecture (flux, sdxl, sd15, etc.)
      category: string;          // Use case category
      supportsSteps: boolean;    // Whether steps parameter is supported
      pricing: {                 // Pricing by resolution
        [resolution: string]: string;  // e.g., "512x512": "$0.0013"
      };
    }
  ];
}

Example Response

{
  "total": 58,
  "models": [
    {
      "id": "flux-schnell",
      "name": "FLUX.1 [schnell]",
      "description": "Ultra-fast FLUX model optimized for speed. Perfect for rapid iteration and testing. 4 steps, 1024×1024 default.",
      "architecture": "flux",
      "category": "fast",
      "supportsSteps": true,
      "pricing": {
        "512x512": "$0.0013",
        "1024x1024": "$0.00195",
        "2048x2048": "$0.00325"
      }
    },
    {
      "id": "sdxl-realvis-v4",
      "name": "RealVisXL V4",
      "description": "Top SDXL model for photorealism with cinematic quality. Excellent detail and lighting.",
      "architecture": "sdxl",
      "category": "realistic",
      "supportsSteps": true,
      "pricing": {
        "512x512": "$0.0019",
        "1024x1024": "$0.00285",
        "2048x2048": "$0.00475"
      }
    }
  ]
}

Response Fields

Model Object

Available Models

FLUX Models (9 models)

State-of-the-art diffusion models with excellent photorealism and speed.

SDXL Models (15 models)

Versatile Stable Diffusion XL models for various styles and use cases.

SD 1.5 Realistic Models (12 models)

Classic Stable Diffusion 1.5 models for realistic imagery.

SD 1.5 Anime & Artistic Models (7 models)

Specialized models for anime, manga, and artistic styles.

Pony & Illustrious Models (3 models)

Specialized architectures for unique styles.

Premium Models (12 models)

High-end models with advanced capabilities and commercial licensing.

Note: Premium models do not support the steps parameter and may have higher minimum resolution requirements.

Architectures

FLUX

State-of-the-art diffusion architecture offering excellent photorealism and fast generation. Best for professional photography, product shots, and realistic scenes.

SDXL (Stable Diffusion XL)

Versatile and widely-used architecture supporting diverse styles from photorealism to artistic rendering. Excellent balance of quality, speed, and flexibility.

SD 1.5 (Stable Diffusion 1.5)

Classic diffusion architecture with extensive community support and many specialized variants. Excellent for anime, illustrations, and artistic styles.

Pony

Specialized architecture with unique style characteristics, particularly effective for certain anime and illustration use cases.

Illustrious

Modern architecture optimized for high-quality anime and illustration generation with improved detail and consistency.

Premium

High-end proprietary models from major AI providers (Google, OpenAI, etc.) offering commercial licensing, advanced capabilities, and maximum quality.

Categories

fast

Optimized for speed while maintaining good quality. Ideal for rapid iteration, testing, and high-volume generation.

realistic

Focused on photorealistic output with accurate lighting, textures, and composition. Best for professional photography, product shots, and realistic scenes.

anime

Specialized for anime and manga styles with vibrant colors, characteristic features, and illustration aesthetics.

artistic

Creative and stylized output for artistic applications, concept art, and creative exploration.

professional

High-quality models with commercial licensing, advanced capabilities, and consistent results for professional applications.

Example Usage

Fetching All Models

async function getImageModels() {
  const response = await fetch('https://api.x-router.ai/v1/images/models');
  const data = await response.json();
 
  console.log(`Total models available: ${data.total}`);
 
  data.models.forEach(model => {
    console.log(`${model.name} (${model.id})`);
    console.log(`  Architecture: ${model.architecture}`);
    console.log(`  Category: ${model.category}`);
    console.log(`  Supports steps: ${model.supportsSteps ? 'Yes' : 'No'}`);
    console.log(`  1024x1024 price: ${model.pricing['1024x1024']}`);
  });
}
 
getImageModels();

Filtering by Architecture

async function getFLUXModels() {
  const response = await fetch('https://api.x-router.ai/v1/images/models');
  const data = await response.json();
 
  const fluxModels = data.models.filter(m => m.architecture === 'flux');
 
  console.log('FLUX models:');
  fluxModels.forEach(model => {
    console.log(`  ${model.name} - ${model.description}`);
  });
}

Filtering by Category

async function getRealisticModels() {
  const response = await fetch('https://api.x-router.ai/v1/images/models');
  const data = await response.json();
 
  const realisticModels = data.models.filter(m => m.category === 'realistic');
 
  console.log('Realistic models:');
  realisticModels.forEach(model => {
    console.log(`  ${model.id}: ${model.name}`);
  });
}

Checking Steps Support

async function getModelsWithSteps() {
  const response = await fetch('https://api.x-router.ai/v1/images/models');
  const data = await response.json();
 
  const stepsModels = data.models.filter(m => m.supportsSteps);
 
  console.log(`${stepsModels.length} models support the steps parameter`);
}

Model Selection Tips

• For photorealism: Choose FLUX or SDXL realistic models
• For anime/illustration: Choose SD 1.5 anime or Illustrious models
• For artistic styles: Choose SDXL artistic or SD 1.5 artistic models
• For speed: Choose models with “fast” in the name or category
• For commercial use: Consider premium models with licensing
• For experimentation: Start with popular models like flux-schnell or sdxl-dreamshaper

See the Model Selection Guide for detailed recommendations based on your use case.

Important Notes

• Model list may expand over time as new models become available
• Premium models have different capabilities and requirements compared to standard models
• The supportsSteps field indicates whether the model accepts the steps parameter
• Pricing varies by resolution and other factors - use the estimate endpoint for accurate costs

Related Endpoints

• Image Generation - Generate images with selected models
• Cost Estimation - Estimate costs for specific models and parameters

Related Guides

• Model Selection Guide - Detailed guide for choosing the right model
• Image Generation Basics - Getting started with image generation