generateImageUrl

Instructions

Implementation Reference

• src/services/imageService.js:25-73 (handler)

  Core handler: Builds a Pollinations image URL from a prompt with parameters (model, seed, width, height, enhance, safe) and returns the URL with metadata.

  export async function generateImageUrl(prompt, model = 'flux', seed = Math.floor(Math.random() * 1000000), width = 1024, height = 1024, enhance = true, safe = false, authConfig = null) {
    if (!prompt || typeof prompt !== 'string') {
      throw new Error('Prompt is required and must be a string');
    }
  
    // Parameters are now directly passed as function arguments
  
    // Build the query parameters
    const queryParams = new URLSearchParams();
  
    // Always include model (with default 'flux')
    queryParams.append('model', model);
  
    // Add other parameters
    if (seed !== undefined) queryParams.append('seed', seed);
    if (width) queryParams.append('width', width);
    if (height) queryParams.append('height', height);
  
    // Add enhance parameter if true
    if (enhance) queryParams.append('enhance', 'true');
  
    // Add parameters
    queryParams.append('nologo', 'true'); // Always set nologo to true
    queryParams.append('private', 'true'); // Always set private to true)
    queryParams.append('safe', safe.toString()); // Use the customizable safe parameter
  
    // Construct the URL
    const encodedPrompt = encodeURIComponent(prompt);
    const baseUrl = 'https://image.pollinations.ai';
    let url = `${baseUrl}/prompt/${encodedPrompt}`;
  
    // Add query parameters
    const queryString = queryParams.toString();
    url += `?${queryString}`;
  
    // Return the URL directly, keeping it simple
    return {
      imageUrl: url,
      prompt,
      width,
      height,
      model,
      seed,
      enhance,
      private: true,
      nologo: true,
      safe
    };
  }

• src/services/imageSchema.js:8-45 (schema)

  Input schema for generateImageUrl tool defining properties: prompt (required string), model, seed, width, height, enhance, safe.

  export const generateImageUrlSchema = {
    name: 'generateImageUrl',
    description: 'Generate an image URL from a text prompt. User-configured settings in MCP config will be used as defaults unless specifically overridden.',
    inputSchema: {
      type: 'object',
      properties: {
        prompt: {
          type: 'string',
          description: 'The text description of the image to generate'
        },
        model: {
          type: 'string',
          description: 'Model name to use for generation (default: user config or "flux"). Use listImageModels to see all available models'
        },
        seed: {
          type: 'number',
          description: 'Seed for reproducible results (default: random)'
        },
        width: {
          type: 'number',
          description: 'Width of the generated image (default: 1024)'
        },
        height: {
          type: 'number',
          description: 'Height of the generated image (default: 1024)'
        },
        enhance: {
          type: 'boolean',
          description: 'Whether to enhance the prompt using an LLM before generating (default: true)'
        },
        safe: {
          type: 'boolean',
          description: 'Whether to apply content filtering (default: false)'
        }
      },
      required: ['prompt']
    }
  };

• pollinations-mcp-server.js:206-222 (registration)

  MCP server handler that routes 'generateImageUrl' tool calls, merges default config with user args, invokes the service, and returns results.

  if (name === 'generateImageUrl') {
    try {
      const { prompt, model = defaultConfig.image.model, seed, width = defaultConfig.image.width, height = defaultConfig.image.height, enhance = defaultConfig.image.enhance, safe = defaultConfig.image.safe } = args;
      const result = await generateImageUrl(prompt, model, seed, width, height, enhance, safe, finalAuthConfig);
      return {
        content: [
          { type: 'text', text: JSON.stringify(result, null, 2) }
        ]
      };
    } catch (error) {
      return {
        content: [
          { type: 'text', text: `Error generating image URL: ${error.message}` }
        ],
        isError: true
      };
    }

• src/index.js:1-29 (registration)

  Re-exports generateImageUrl from imageService.js as the public API entry point.

  /**
   * Pollinations API Client
   *
   * A simple client for the Pollinations APIs that follows the thin proxy design principle
   */
  
  // Import services
  import { generateImageUrl, generateImage, editImage, generateImageFromReference, listImageModels } from './services/imageService.js';
  import { respondAudio, listAudioVoices } from './services/audioService.js';
  import { respondText, listTextModels } from './services/textService.js';
  
  
  // Export all service functions
  export {
    // Image services
    generateImageUrl,
    generateImage,
    editImage,
    generateImageFromReference,
    listImageModels,
  
    // Audio services
    respondAudio,
    listAudioVoices,
  
    // Text services
    respondText,
    listTextModels,
  };

• src/schemas.js:32-44 (registration)

  Registers generateImageUrlSchema in the getAllToolSchemas() array for tool listing.

  export function getAllToolSchemas() {
    return [
      generateImageUrlSchema,
      generateImageSchema,
      editImageSchema,
      generateImageFromReferenceSchema,
      listImageModelsSchema,
      respondAudioSchema,
      listAudioVoicesSchema,
      respondTextSchema,
      listTextModelsSchema
    ];
  }