Tcl

Referencing a Pre-Uploaded Image File by file_id in an AI Request

See more AI Examples

Currently, OpenAI is the only AI provider that supports referencing a pre-uploaded image in a request for text generation. Tcl

load ./chilkat.dll

set success 0

set success 0

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

set ai [new_CkAi]

# OpenAI is currently the only AI provider that supports referencing a pre-uploaded image by file_id
# in a request for text generation.
CkAi_put_Provider $ai "openai"

# Use your provider's API key.
CkAi_put_ApiKey $ai "MY_API_KEY"

# Choose a model.
CkAi_put_Model $ai "gpt-5-mini"

# See the following example showing how to upload a file
# Upload an Image File to an AI Provider

# Use the file_id of the pre-uploaded file.
set file_id "file-5CnBeuFasqNcAfti3cx4Fe"
CkAi_InputAddImageFileId $ai $file_id "application/json"

CkAi_InputAddText $ai "What is in this image?"

# Ask the AI for text output.
set success [CkAi_Ask $ai "text"]
if {$success == 0} then {
    puts [CkAi_lastErrorText $ai]
    delete_CkAi $ai
    exit
}

# Get the text response.
set sbResponse [new_CkStringBuilder]

CkAi_GetOutputTextSb $ai $sbResponse
puts [CkStringBuilder_getAsString $sbResponse]

delete_CkAi $ai
delete_CkStringBuilder $sbResponse