SkinbaseNova/config/vision.php

<?php

declare(strict_types=1);

return [
    'enabled' => env('VISION_ENABLED', true),

    'auto_tagging' => [
        'enabled' => env('VISION_AUTO_TAGGING_ENABLED', false),
    ],

    'upload' => [
        'embeddings' => [
            'enabled' => env('VISION_UPLOAD_EMBEDDINGS_ENABLED', true),
        ],
        'maturity' => [
            'enabled' => env('VISION_UPLOAD_MATURITY_ENABLED', false),
        ],
        'ai_assist' => [
            'enabled' => env('VISION_UPLOAD_AI_ASSIST_ENABLED', false),
        ],
    ],

    'queue' => env('VISION_QUEUE', 'default'),

    'clip' => [
        'base_url' => env('CLIP_BASE_URL', ''),
        'endpoint' => env('CLIP_ANALYZE_ENDPOINT', '/analyze'),
        'api_key' => env('CLIP_API_KEY', env('VISION_API_KEY', env('VISION_VECTOR_GATEWAY_API_KEY', ''))),
        'timeout_seconds' => (int) env('CLIP_TIMEOUT_SECONDS', 8),
        'connect_timeout_seconds' => (int) env('CLIP_CONNECT_TIMEOUT_SECONDS', 2),
        'retries' => (int) env('CLIP_HTTP_RETRIES', 1),
        'retry_delay_ms' => (int) env('CLIP_HTTP_RETRY_DELAY_MS', 200),
    ],

    'yolo' => [
        'enabled' => env('YOLO_ENABLED', true),
        'base_url' => env('YOLO_BASE_URL', ''),
        'endpoint' => env('YOLO_ANALYZE_ENDPOINT', '/analyze'),
        'api_key' => env('YOLO_API_KEY', env('VISION_API_KEY', env('VISION_VECTOR_GATEWAY_API_KEY', ''))),
        'timeout_seconds' => (int) env('YOLO_TIMEOUT_SECONDS', 8),
        'connect_timeout_seconds' => (int) env('YOLO_CONNECT_TIMEOUT_SECONDS', 2),
        'retries' => (int) env('YOLO_HTTP_RETRIES', 1),
        'retry_delay_ms' => (int) env('YOLO_HTTP_RETRY_DELAY_MS', 200),

        // Only run YOLO for photography content type.
        'photography_only' => env('YOLO_PHOTOGRAPHY_ONLY', true),
    ],

    // Which derivative variant to send to vision services.
    'image_variant' => env('VISION_IMAGE_VARIANT', 'md'),

    /*
     |--------------------------------------------------------------------------
     | Vision Gateway (aggregates CLIP + BLIP + YOLO via /analyze/all)
     |--------------------------------------------------------------------------
     | Falls back to CLIP base_url when VISION_GATEWAY_URL is not set.
     */
    'gateway' => [
        'base_url'               => env('VISION_GATEWAY_URL', env('CLIP_BASE_URL', '')),
        'api_key'                => env('VISION_GATEWAY_API_KEY', env('VISION_API_KEY', env('VISION_VECTOR_GATEWAY_API_KEY', ''))),
        'timeout_seconds'        => (int) env('VISION_GATEWAY_TIMEOUT', 60),
        'connect_timeout_seconds'=> (int) env('VISION_GATEWAY_CONNECT_TIMEOUT', 3),
    ],

    'maturity' => [
        'base_url' => env('VISION_MATURITY_URL', env('VISION_GATEWAY_URL', env('CLIP_BASE_URL', ''))),
        'endpoint' => env('VISION_MATURITY_ENDPOINT', '/analyze/maturity'),
        'file_endpoint' => env('VISION_MATURITY_FILE_ENDPOINT', '/analyze/maturity/file'),
        'api_key' => env('VISION_MATURITY_API_KEY', env('VISION_GATEWAY_API_KEY', env('VISION_API_KEY', env('VISION_VECTOR_GATEWAY_API_KEY', '')))),
        'timeout_seconds' => (int) env('VISION_MATURITY_TIMEOUT', 20),
        'connect_timeout_seconds' => (int) env('VISION_MATURITY_CONNECT_TIMEOUT', 3),
        'retries' => (int) env('VISION_MATURITY_RETRIES', 1),
        'retry_delay_ms' => (int) env('VISION_MATURITY_RETRY_DELAY_MS', 200),
    ],

    'vector_gateway' => [
        'enabled' => env('VISION_VECTOR_GATEWAY_ENABLED', true),
        'base_url' => env('VISION_VECTOR_GATEWAY_URL', ''),
        'api_key' => env('VISION_VECTOR_GATEWAY_API_KEY', ''),
        'collection' => env('VISION_VECTOR_GATEWAY_COLLECTION', 'images'),
        'timeout_seconds' => (int) env('VISION_VECTOR_GATEWAY_TIMEOUT', 20),
        'connect_timeout_seconds' => (int) env('VISION_VECTOR_GATEWAY_CONNECT_TIMEOUT', 5),
        'retries' => (int) env('VISION_VECTOR_GATEWAY_RETRIES', 1),
        'retry_delay_ms' => (int) env('VISION_VECTOR_GATEWAY_RETRY_DELAY_MS', 250),

        // Tighter budget for the read/search path, which runs synchronously inside
        // web requests (unlike upsert/delete, which only run from queued/console
        // indexing jobs). Keeps a slow or unreachable gateway from pinning FPM
        // workers for 20s+ per request.
        'search_timeout_seconds' => (int) env('VISION_VECTOR_GATEWAY_SEARCH_TIMEOUT', 6),
        'search_connect_timeout_seconds' => (int) env('VISION_VECTOR_GATEWAY_SEARCH_CONNECT_TIMEOUT', 2),
        'search_retries' => (int) env('VISION_VECTOR_GATEWAY_SEARCH_RETRIES', 0),

        // Once a search call fails, stop attempting new ones for this many seconds
        // (circuit breaker) — avoids every concurrent request for a different
        // artwork independently blocking on the same downed/slow gateway.
        'circuit_breaker_seconds' => (int) env('VISION_VECTOR_GATEWAY_CIRCUIT_SECONDS', 30),
        'upsert_endpoint' => env('VISION_VECTOR_GATEWAY_UPSERT_ENDPOINT', '/vectors/upsert'),
        'upsert_file_endpoint' => env('VISION_VECTOR_GATEWAY_UPSERT_FILE_ENDPOINT', '/vectors/upsert/file'),
        'search_endpoint' => env('VISION_VECTOR_GATEWAY_SEARCH_ENDPOINT', '/vectors/search'),
        'search_file_endpoint' => env('VISION_VECTOR_GATEWAY_SEARCH_FILE_ENDPOINT', '/vectors/search/file'),
        'delete_endpoint' => env('VISION_VECTOR_GATEWAY_DELETE_ENDPOINT', '/vectors/delete'),
        'collections_endpoint' => env('VISION_VECTOR_GATEWAY_COLLECTIONS_ENDPOINT', '/vectors/collections'),
    ],

    'tag_suggestions' => [
        'provider' => env('VISION_TAG_SUGGESTIONS_PROVIDER', 'lm_studio'),
    ],

    'together' => [
        'base_url' => env('VISION_TOGETHER_BASE_URL', 'https://api.together.xyz'),
        'endpoint' => env('VISION_TOGETHER_ENDPOINT', '/v1/chat/completions'),
        'model' => env('VISION_TOGETHER_MODEL', 'meta-llama/Llama-3.2-11B-Vision-Instruct-Turbo'),
        'api_key' => env('VISION_TOGETHER_API_KEY', env('TOGETHER_API_KEY', '')),
        'timeout' => (int) env('VISION_TOGETHER_TIMEOUT', 90),
        'connect_timeout' => (int) env('VISION_TOGETHER_CONNECT_TIMEOUT', 5),
    ],

    /*
     |--------------------------------------------------------------------------
     | LM Studio – local multimodal inference (tag generation)
     |--------------------------------------------------------------------------
     */
    'lm_studio' => [
        'base_url'        => env('LM_STUDIO_URL', 'http://192.168.0.100:8200'),
        'model'           => env('LM_STUDIO_MODEL', 'google/gemma-3-4b'),
        'timeout'         => (int) env('LM_STUDIO_TIMEOUT', 60),
        'connect_timeout' => (int) env('LM_STUDIO_CONNECT_TIMEOUT', 5),
        'temperature'     => (float) env('LM_STUDIO_TEMPERATURE', 0.3),
        'max_tokens'      => (int) env('LM_STUDIO_MAX_TOKENS', 300),
        // Maximum number of AI-suggested tags to keep per artwork.
        'max_tags'        => (int) env('LM_STUDIO_MAX_TAGS', 12),
    ],
];