Troubleshooting

Troubleshooting

The session remains in "pending" status

Cause: The queue worker is not running.

Solution: Verify that the worker is active:

php artisan queue:listen

401 Unauthorized Error

Cause: Missing or incorrect API key.

Solution: Verify that the X-API-Key header is present and contains the correct key configured in the .env file.

The session goes to "failed" status

Possible causes:

• Error communicating with the Google Gemini API
• Invalid data format for the selected template
• Timeout in the AI model response

Solution: Check the application logs:

tail -f storage/logs/laravel.log

422 Error on ingest request

Cause: Input data does not conform to validation rules.

Solution: Verify that:

• The template field contains a valid value
• The products field is a non-empty array
• The template-specific parameters are present (e.g., source_lang and target_lang for translate)

PDF files rejected

Cause: The file exceeds the 20MB limit or is not in PDF format.

Solution: Check the file size and format. Only .pdf files with MIME type application/pdf are accepted.