label. */ function aatg_get_providers() { return array( 'openai' => __( 'OpenAI', 'ai-auto-alt-text-generator' ), 'anthropic' => __( 'Anthropic (Claude)', 'ai-auto-alt-text-generator' ), 'deepseek' => __( 'DeepSeek', 'ai-auto-alt-text-generator' ), ); } /** * Vision models the plugin can use. * * Each entry: provider ID, label, and request tuning read by the provider class: * - openai: reasoning_effort * - anthropic: effort, fallbacks (server-side refusal fallback; not on Haiku) * - deepseek: thinking ('disabled') * * @return array Model ID => array( 'provider' => string, 'label' => string, 'tuning' => array ). */ function aatg_get_models() { $models = array( 'gpt-6-luna' => array( 'provider' => 'openai', 'label' => __( 'GPT-6 Luna — fastest & cheapest (default)', 'ai-auto-alt-text-generator' ), 'tuning' => array( 'reasoning_effort' => 'none' ), ), 'gpt-6.1-sol' => array( 'provider' => 'openai', 'label' => __( 'GPT-6.1 Sol — highest quality', 'ai-auto-alt-text-generator' ), 'tuning' => array( 'reasoning_effort' => 'low' ), ), 'gpt-5.6-luna' => array( 'provider' => 'openai', 'label' => __( 'GPT-5.6 Luna — previous generation', 'ai-auto-alt-text-generator' ), 'tuning' => array( 'reasoning_effort' => 'low' ), ), 'gpt-5.6-terra' => array( 'provider' => 'openai', 'label' => __( 'GPT-5.6 Terra — previous generation, higher quality', 'ai-auto-alt-text-generator' ), 'tuning' => array( 'reasoning_effort' => 'low' ), ), 'claude-haiku-5-5' => array( 'provider' => 'anthropic', 'label' => __( 'Claude Haiku 5.5 — fast & low cost', 'ai-auto-alt-text-generator' ), 'tuning' => array( 'effort' => 'low', 'fallbacks' => false ), ), 'claude-sonnet-5-5' => array( 'provider' => 'anthropic', 'label' => __( 'Claude Sonnet 5.5 — higher quality', 'ai-auto-alt-text-generator' ), 'tuning' => array( 'effort' => 'low', 'fallbacks' => true ), ), 'claude-opus-5-5' => array( 'provider' => 'anthropic', 'label' => __( 'Claude Opus 5.5 — most capable, highest cost', 'ai-auto-alt-text-generator' ), 'tuning' => array( 'effort' => 'low', 'fallbacks' => true ), ), 'deepseek-flash' => array( 'provider' => 'deepseek', 'label' => __( 'DeepSeek V4.1 Flash — low cost', 'ai-auto-alt-text-generator' ), 'tuning' => array( 'thinking' => 'disabled' ), ), ); /** * Filter the available models. Add an entry to offer another vision model * from a supported provider. * * @param array $models Model ID => array( 'provider', 'label', 'tuning' ). */ $models = apply_filters( 'aatg_models', $models ); $providers = aatg_get_providers(); foreach ( $models as $id => $model ) { if ( ! is_array( $model ) || empty( $model['provider'] ) || ! isset( $providers[ $model['provider'] ] ) ) { unset( $models[ $id ] ); continue; } $models[ $id ] += array( 'label' => $id, 'tuning' => array(), ); } return $models; } /** * Model options for dropdowns (kept for back-compat). * * @return array Model ID => label. */ function aatg_get_model_options() { return wp_list_pluck( aatg_get_models(), 'label' ); } /** * Resolve the configured model, falling back to the default if invalid. * * @return string Model ID. */ function aatg_get_selected_model() { $current = get_option( 'aatg_openai_model', AATG_DEFAULT_MODEL ); if ( ! is_string( $current ) || ! array_key_exists( $current, aatg_get_models() ) ) { return AATG_DEFAULT_MODEL; } return $current; } /** * Provider ID for a model. * * @param string $model Model ID. * @return string Provider ID, or '' when the model is unknown. */ function aatg_get_model_provider( $model ) { $models = aatg_get_models(); return isset( $models[ $model ] ) ? $models[ $model ]['provider'] : ''; } /** * Models OpenAI has retired or scheduled for shutdown, mapped to their replacement. * GPT-6 Luna costs less than every one of them, so migrating never raises a bill. * * @return array Old model ID => replacement model ID. */ function aatg_get_retired_models() { return array( 'gpt-4o-mini' => 'gpt-6-luna', 'gpt-5-mini' => 'gpt-6-luna', 'gpt-5-nano' => 'gpt-6-luna', 'gpt-5.4-mini' => 'gpt-6-luna', 'gpt-5.4-nano' => 'gpt-6-luna', ); } /** * The API key for a provider. * * Looked up from, in order: a wp-config.php constant (e.g. AATG_ANTHROPIC_API_KEY), * an environment variable of the same name, then the saved option. * * @param string $provider Provider ID. * @return string API key, or '' when none is configured. */ function aatg_get_api_key( $provider ) { $key = ''; $source = aatg_api_key_source( $provider ); $name = 'AATG_' . strtoupper( $provider ) . '_API_KEY'; if ( 'constant' === $source ) { $key = (string) constant( $name ); } elseif ( 'env' === $source ) { $key = (string) getenv( $name ); } elseif ( 'option' === $source ) { $key = (string) get_option( 'aatg_' . $provider . '_api_key', '' ); } /** * Filter the API key used for a provider. * * @param string $key API key. * @param string $provider Provider ID (openai, anthropic, deepseek). */ return trim( (string) apply_filters( 'aatg_api_key', $key, $provider ) ); } /** * Where a provider's API key comes from. * * @param string $provider Provider ID. * @return string 'constant', 'env', 'option', or '' when not configured. */ function aatg_api_key_source( $provider ) { $name = 'AATG_' . strtoupper( (string) $provider ) . '_API_KEY'; if ( defined( $name ) && '' !== (string) constant( $name ) ) { return 'constant'; } if ( '' !== (string) getenv( $name ) ) { return 'env'; } if ( '' !== (string) get_option( 'aatg_' . $provider . '_api_key', '' ) ) { return 'option'; } return ''; } /** * Kept from 1.x: an OpenAI Chat Completions payload for the selected model. * Requests now go through aatg_get_provider(); this remains for custom code. * * @param array $messages Chat messages array. * @param string $context Either 'alt text' or 'title' (passed to the filter). * @return array */ function aatg_build_request_payload( $messages, $context ) { $model = aatg_get_selected_model(); $models = aatg_get_models(); $payload = array( 'model' => $model, 'messages' => $messages, ); if ( ! empty( $models[ $model ]['tuning']['reasoning_effort'] ) ) { $payload['reasoning_effort'] = $models[ $model ]['tuning']['reasoning_effort']; } /** This filter is documented in includes/providers/class-aatg-provider-openai.php */ return apply_filters( 'aatg_openai_request_payload', $payload, $context, $messages ); }