replacement model ID. */ public function get_retired_models(): array { return array( 'models/gemini-3.1-flash-lite' => 'models/gemini-3.5-flash-lite', // Shutdown May 7, 2027. 'models/gemini-2.5-pro' => 'models/gemini-3.8-flash', // Shutdown October 16, 2026. 'models/gemini-2.5-flash' => 'models/gemini-3.5-flash', // Shutdown October 16, 2026. 'models/gemini-2.5-flash-lite' => 'models/gemini-3.5-flash-lite', // Shutdown October 16, 2026. 'models/gemini-2.0-flash' => 'models/gemini-3.6-flash', // Shut down June 1, 2026. 'models/gemini-2.0-flash-lite' => 'models/gemini-3.5-flash-lite', // Shut down June 1, 2026. 'models/gemini-1.5-flash' => 'models/gemini-3.5-flash', 'models/gemini-1.5-pro' => 'models/gemini-3.8-flash', ); } /** * Request headers carrying the provider credentials. * * @since 2.3.0 * @return array */ protected function get_auth_headers(): array { return array( 'x-goog-api-key' => $this->api_key ); } /** * Fetch available Gemini models dynamically. * * @param bool $force Bypass the cached model list. * * @since 1.0.0 * @return array|\WP_Error List of models. */ public function get_models( bool $force = false ) { $cache_key = 'aicw_gemini_models_' . md5( $this->api_key ); $cached = $force ? false : get_transient( $cache_key ); if ( false !== $cached ) { return $cached; } $response = $this->get_request( 'models' ); if ( isset( $response['error'] ) ) { return new \WP_Error( 'aicw_gemini_api_error', $this->get_response_error( $response, esc_html__( 'API key not valid. Please pass a valid API key.', 'ai-content-writer' ) ) ); } if ( empty( $response['models'] ) ) { return new \WP_Error( 'aicw_gemini_no_models', esc_html__( 'No models found or API key not valid. Please pass a valid API key.', 'ai-content-writer' ) ); } $models = array(); $allowed_models = array( 'models/gemini-3.8-flash', 'models/gemini-3.7-flash', 'models/gemini-3.6-flash', 'models/gemini-3.5-flash', 'models/gemini-3.5-flash-lite', 'models/gemini-flash-latest', 'models/gemini-flash-lite-latest', 'models/gemini-pro-latest', ); foreach ( $response['models'] as $model ) { if ( ! isset( $model['name'] ) ) { continue; } if ( ! in_array( $model['name'], $allowed_models, true ) ) { continue; } $model_id = sanitize_text_field( $model['name'] ); $display_name = $model['displayName'] ?? $model_id; $models[ $model_id ] = esc_html( $display_name ); } // Update the option to store the models for the settings page. update_option( 'aicw_gemini_models', $models ); // Cache for 24 hours. set_transient( $cache_key, $models, DAY_IN_SECONDS ); return $models; } /** * Generate text for a prompt and return the plain text output. * * @param string $prompt The user prompt. * @param array $args Optional. `model`, `system`, `timeout`, `json` (bool — force a JSON object response). * * @since 2.3.0 * @return string|\WP_Error The generated text or WP_Error on failure. */ public function generate( string $prompt, array $args = array() ) { if ( ! $this->is_configured() ) { return $this->not_configured_error(); } $model = ! empty( $args['model'] ) ? $this->replace_retired_model( (string) $args['model'] ) : $this->get_default_model(); // The API expects the fully-qualified model name. if ( 0 !== strpos( $model, 'models/' ) ) { $model = 'models/' . $model; } $data = array( 'contents' => array( array( 'role' => 'user', 'parts' => array( array( 'text' => $prompt ), ), ), ), ); if ( ! empty( $args['system'] ) ) { $data['systemInstruction'] = array( 'parts' => array( array( 'text' => (string) $args['system'] ), ), ); } // Enforce a JSON object response at the API level. if ( ! empty( $args['json'] ) ) { $data['generationConfig']['responseMimeType'] = 'application/json'; } $timeout = ! empty( $args['timeout'] ) ? absint( $args['timeout'] ) : 300; $response = $this->post_request( $model . ':generateContent', $data, $timeout ); if ( isset( $response['candidates'][0]['content']['parts'][0]['text'] ) ) { return (string) $response['candidates'][0]['content']['parts'][0]['text']; } return new \WP_Error( 'aicw_gemini_generate_error', $this->get_response_error( $response ) ); } }