Developer API

SleekAI defines a few global PHP functions. They exist only while SleekAI is active, so guard calls with function_exists() in code that can run without it. Its hooks, WP-CLI commands and REST operations are listed in the generated references: hooks, CLI and REST.

Generate a response

sleekAi_generate_response() sends one request to a provider with the stored API key and waits for the complete reply.

if (function_exists('sleekAi_generate_response')) {
    $response = sleekAi_generate_response([
        'model' => 'openai-gpt-4.1-nano',
        'messages' => [
            [
                'role' => 'system',
                'content' => 'You are a helpful assistant.',
            ],
            [
                'role' => 'user',
                'content' => 'What is 1 + 1?',
            ],
        ],
    ]);

    if ($response['success']) {
        $answer = $response['content'];
    } else {
        error_log('SleekAI: ' . $response['error']);
    }
}

Arguments

Model

model is the provider, a hyphen and the provider’s model identifier:

SleekAI turns every underscore into a hyphen before it splits the string, so openai_gpt-4.1-nano works too. wp sleek ai models list prints the model identifiers available with the stored keys.

Custom models belong to the user who created them, and SleekAI finds one only while that user is the current user. Cron jobs, visitor requests and WP-CLI calls without --user therefore need a provider model.

Return value

The function returns an array. On success it holds the reply text in content; on failure it holds a message in error, for example API key not found for provider: openai, or HTTP 401: followed by the provider’s response.

$success = [
    'success' => true,
    'content' => '1 + 1 equals 2.',
];

$failure = [
    'success' => false,
    'error' => 'API key not found for provider: openai',
];

Providers

The same messages work for every provider: SleekAI converts them to each provider’s format. The request does not stream and blocks until the provider answers, so run it in a background task or an admin action rather than on every page view.

Render a chatbot

sleekAi_render_chatbot() prints a chatbot built from an array. See the Chatbot API.

Other functions

• sleekAi() returns the SleekAi\Plugin instance, which has getVersion(), getPluginDir(), getPluginFile() and getPluginUrl().
• sleekAi_use_polling() returns whether replies are polled rather than streamed, after the sleekAi/polling filter; see Streaming.

if (function_exists('sleekAi')) {
    $version = sleekAi()->getVersion();
    $polling = sleekAi_use_polling();
}

To run code once SleekAI has booted, use the sleekAi/init action, which passes the same instance. SleekAI boots on plugins_loaded, so add the callback from a plugin; a theme loads too late to catch it.