Filter reference

Every filter Aimogen Pro exposes, with its parameters and purpose, plus the per-provider API key filters.

Aimogen Pro exposes 107 filters. They are the documented way to change plugin behaviour without touching its code.

The ones you will use most#

Examples#

Append a house-style instruction to every prompt:

add_filter( 'aiomatic_modify_ai_query', function ( $query ) {
    if ( is_string( $query ) ) {
        return $query . "\n\nWrite in British English. Do not use the word 'delve'.";
    }
    return $query;
} );

Strip a phrase the model keeps adding:

add_filter( 'aiomatic_modify_ai_reply', function ( $text, $query ) {
    return preg_replace( '/^\s*In conclusion,\s*/mi', '', $text );
}, 10, 2 );

Route expensive work to a cheaper model:

add_filter( 'aiomatic_model_selection', function ( $model ) {
    // Titles and excerpts do not need the flagship model.
    if ( did_action( 'aiomatic_before_completion_ai_query' ) && $model === 'gpt-5.5' ) {
        return 'gpt-5-nano';
    }
    return $model;
} );

Block AI use outside working hours:

add_filter( 'aiomatic_ai_allowed', function ( $allowed, $limits, $query ) {
    $hour = (int) current_time( 'G' );
    return ( $hour >= 8 && $hour < 20 ) ? $allowed : false;
}, 10, 3 );

Supply an API key from a constant instead of the database:

add_filter( 'aimogen_openai_api_key', function () {
    return defined( 'MY_OPENAI_KEY' ) ? MY_OPENAI_KEY : '';
} );

Correct the visitor IP behind a CDN:

add_filter( 'aiomatic_get_ip', function ( $ip ) {
    if ( ! empty( $_SERVER['HTTP_CF_CONNECTING_IP'] ) ) {
        return sanitize_text_field( wp_unslash( $_SERVER['HTTP_CF_CONNECTING_IP'] ) );
    }
    return $ip;
} );

Without this, per-IP limits and blocks see every visitor as one address.

Provider credential filters#

Each provider credential passes through a filter, so keys can be supplied from wp-config.php, an environment variable or a secrets manager rather than stored in the database.

Where both an aimogen_ and an aiomatic_ filter exist for the same credential, the aiomatic_ one runs second and therefore wins.

See Where credentials are stored.

Complete reference#

Notes#

Parameter counts. Always pass the correct $accepted_args to add_filter(). Filters listed with several parameters give none of them unless you ask for them.

Return the value. A filter that returns nothing sets the filtered value to null, usually with dramatic results.

Filters run for every request, including the PHP API, the REST API, WP-CLI, the chatbot and agents. Scope your logic if you only mean to affect one of them — the env value passed to many hooks helps.

Related#

• Action reference
• Custom AI tools and function calling
• Debugging prompts