(Unicode C) Azure AI Foundry Query

This is the simplest example of using Chilkat with Azure AI Foundry.

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

Chilkat C/C++ Library Downloads
MS Visual C/C++ C++ Builder Linux C/C++ Alpine Linux C/C++	MacOS C/C++ iOS C/C++ Android C/C++ MinGW C/C++

#include <C_CkAiW.h>
#include <C_CkJsonObjectW.h>
#include <C_CkStringBuilderW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkAiW ai;
    HCkJsonObjectW azureParams;
    HCkStringBuilderW sbResponse;

    success = FALSE;

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

    ai = CkAiW_Create();

    // Before running the code, ensure the following prerequisites for App Registration in Microsoft Entra ID for Azure AI Foundry:
    // 1. Register an app for Azure AI Foundry.
    // 2. Assign an IAM Role to the resource to enable OAuth2 Client-Credentials for calling Azure AI Foundry.

    // For Azure AI Foundry we use "custom".
    CkAiW_putProvider(ai,L"custom");

    // The base URL format for the Chat Completions API when using the cognitiveservices.azure.com domain is:
    // https://{resource-name}.cognitiveservices.azure.com/openai/deployments/{deployment-id}/chat/completions?api-version={api-version}

    // The string "{deployment}" in the base URL is dynamically replaced with the selected AI model each time a request is sent.
    // In this case, the chosen model (below) is "gpt-4o".  After substitution the base URL becomes: 
    // https://chilkat.cognitiveservices.azure.com/openai/deployments/gpt-4o/chat/completions?api-version=2025-01-01-preview

    // In this example, our resource name is "chilkat", and the api-version is "2025-01-01-preview"
    CkAiW_putBaseUrl(ai,L"https://chilkat.cognitiveservices.azure.com/openai/deployments/{deployment}/chat/completions?api-version=2025-01-01-preview");
    CkAiW_putApiSpec(ai,L"ChatCompletions");

    // Use your provider's API key.
    CkAiW_putApiKey(ai,L"MY_API_KEY");

    // Set Azure Foundry specific params.
    azureParams = CkJsonObjectW_Create();

    // The tenant ID is a GUID such as 17280f2d-f709-4a7b-af1d-9928190e13cf
    CkJsonObjectW_UpdateString(azureParams,L"azure.tenantId",L"TENANT_ID");

    // The client ID is a GUID such as 4abd4bf6-5260-4795-90f6-1e91ce4f582c
    CkJsonObjectW_UpdateString(azureParams,L"azure.clientId",L"CLIENT_ID");

    // Such as UZc8Q~YBrRIgfe_zbAOwWV.8ikuHa3JJF7LvCdt.  (this is not a GUID)
    CkJsonObjectW_UpdateString(azureParams,L"azure.clientSecret",L"CLIENT_SECRET");

    // The subscription ID is a GUID such as 4abd4bf6-5260-4795-90f6-1e91ce4f582c
    CkJsonObjectW_UpdateString(azureParams,L"azure.subscription",L"SUBSCRIPTION_ID");

    // Such as eastus
    CkJsonObjectW_UpdateString(azureParams,L"azure.location",L"LOCATION");

    // With the Azure-specific provider params specified,
    // Chilkat will internally fetch the OAuth2 access token using client credentials as needed.
    CkAiW_SetProviderParams(ai,azureParams);

    // Choose a model.
    CkAiW_putModel(ai,L"gpt-4o");

    // Add a text input.
    CkAiW_InputAddText(ai,L"Say Hello.");

    // Ask the AI for text output.
    success = CkAiW_Ask(ai,L"text");
    if (success == FALSE) {
        wprintf(L"%s\n",CkAiW_lastErrorText(ai));
        CkAiW_Dispose(ai);
        CkJsonObjectW_Dispose(azureParams);
        return;
    }

    // Get the text response.
    sbResponse = CkStringBuilderW_Create();
    CkAiW_GetOutputTextSb(ai,sbResponse);
    wprintf(L"%s\n",CkStringBuilderW_getAsString(sbResponse));

    // Sample output:
    // Hello! How can I assist you today?

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


    CkAiW_Dispose(ai);
    CkJsonObjectW_Dispose(azureParams);
    CkStringBuilderW_Dispose(sbResponse);

    }