Objective-C

Multimodal Input: Image Data

See more AI Examples

Demonstrates sending a request that includes both text and image data for the AI to analyze. Objective-C

#import <CkoAi.h>
#import <CkoBinData.h>
#import <CkoStringBuilder.h>

BOOL success = NO;

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

CkoAi *ai = [[CkoAi alloc] init];

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

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

//  Choose a model.
ai.Model = @"grok-4";

//  Add both text input, and image data
[ai InputAddText: @"Describe what you see in the following image."];

CkoBinData *bd = [[CkoBinData alloc] init];
//  We're passing a relative local file path here.. (relative the the app's current working directory)
success = [bd LoadFile: @"qa_data/jpg/starfish.jpg"];
if (success == NO) {
    NSLog(@"%@",bd.LastErrorText);
    return;
}

[ai InputAddImageData: bd summary: @""];

//  Ask the AI for text output.
success = [ai Ask: @"text"];
if (success == NO) {
    NSLog(@"%@",ai.LastErrorText);
    return;
}

//  Get the text response.
CkoStringBuilder *sbResponse = [[CkoStringBuilder alloc] init];
[ai GetOutputTextSb: sbResponse];
NSLog(@"%@",[sbResponse GetAsString]);

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

//  Sample output:

//  The image depicts a small, bright orange starfish (also known as a sea star) with five symmetrical arms radiating from a central disc. 
//  It has a textured, bumpy surface that gives it a realistic, almost spiky appearance, and there's a small hole or indentation at the center, 
//  which might represent the mouth or a natural feature. The starfish is shown against a plain white background, and it appears to be a simple, 
//  illustrative or clipart-style graphic rather than a photograph.