(Node.js) Multimodal Input: Image URL

See more AI Examples

Note: This example requires Chilkat v11.2.0 or greater.

Install Chilkat for Node.js and Electron using npm at Chilkat npm packages for Node.js Chilkat npm packages for Electron on Windows, Linux, MacOS

var os = require('os');
if (os.platform() == 'win32') {  
  var chilkat = require('@chilkat/ck-node23-win64'); 
} else if (os.platform() == 'linux') {
    if (os.arch() == 'arm') {
        var chilkat = require('@chilkat/ck-node23-linux-arm');
    } else if (os.arch() == 'arm64') {
        var chilkat = require('@chilkat/ck-node23-linux-arm64');
    } else {
        var chilkat = require('@chilkat/ck-node23-linux-x64');
    }
} else if (os.platform() == 'darwin') {
  var chilkat = require('@chilkat/ck-node23-mac-universal');
}

function chilkatExample() {

    var success = false;

    // This example assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    var ai = new chilkat.Ai();

    // The provider can be "openai", "google", "claude", "deepseek", "xai", or "perplexity".
    // Support for additional providers will be added in future versions of Chilkat.
    ai.Provider = "google";

    // Use your provider's API key.
    ai.ApiKey = "MY_API_KEY";

    // Choose a model.
    ai.Model = "gemini-2.5-flash";

    // Add both text input, and an image URL.
    // If the AI provider does not natively support image URLs, Chilkat will download the image data to memory and send the image data to the AI provider (within the "Ask" method call).
    ai.InputAddText("Describe what you see in the following image.");
    ai.InputAddImageUrl("https://www.chilkatsoft.com/images/starfish.jpg","");

    // Ask the AI for text output.
    success = ai.Ask("text");
    if (success == false) {
        console.log(ai.LastErrorText);
        return;
    }

    // Get the text response.
    var sbResponse = new chilkat.StringBuilder();
    ai.GetOutputTextSb(sbResponse);
    console.log(sbResponse.GetAsString());

    // -------------------------------------------------------------
    // The response is in markdown format.
    // Also see Markdown to HTML Conversion Examples.
    // -------------------------------------------------------------

    // Sample output:

    // The image displays a single, vibrant **starfish** set against a plain **white background**.
    // 
    // Here's a more detailed description:
    // 
    // *   **Object:** A single starfish.
    // *   **Shape:** It has the characteristic five-pointed star shape, with each arm tapering slightly to a rounded end. The arms appear somewhat plump and substantial.
    // *   **Color:** The starfish is a beautiful **warm, golden-orange color**, with subtle variations in hue that suggest natural texture and depth. Some areas might lean a little more yellow, while others have a slightly richer, deeper orange tone.
    // *   **Texture:** Its entire surface is visibly **textured**, covered in numerous small, raised bumps or granular patterns. These details are consistent across all the arms and the central body, giving it a rough, almost sandpaper-like appearance, typical of a real starfish.
    // *   **Lighting & Depth:** The lighting on the starfish highlights these textures, creating subtle shadows in the crevices between the bumps and making the object appear distinctly three-dimensional and lifelike. The light seems to come from above, casting gentle shadows that define its form.
    // *   **Background:** The starfish is isolated against a pure white, featureless background, which makes it stand out prominently as the sole subject of the image.
    // 
    // Overall, it's a clear, well-lit photograph of a textured, orange starfish.

}

chilkatExample();