{"record":{"id":"a6ccec23df7e9099","repo":"spring-projects/spring-ai","slug":"unsupported-spring-ai-openai-audio-transcription-c","errorCode":null,"errorMessage":"Unsupported spring.ai.openai.audio.transcription.chunking-strategy value: '<chunkingStrategy>'. Only 'auto' is supported through configuration properties; use OpenAiAudioTranscriptionOptions.Builder#chunkingStrategy(...) programmatically for voice-activity-detection tuning.","messagePattern":"Unsupported spring\\.ai\\.openai\\.audio\\.transcription\\.chunking-strategy value: '<chunkingStrategy>'\\. Only 'auto' is supported through configuration properties; use OpenAiAudioTranscriptionOptions\\.Builder#chunkingStrategy\\(\\.\\.\\.\\) programmatically for voice-activity-detection tuning\\.","errorType":"validation","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"auto-configurations/models/spring-ai-autoconfigure-model-openai/src/main/java/org/springframework/ai/model/openai/autoconfigure/OpenAiAudioTranscriptionProperties.java","lineNumber":172,"sourceCode":"\t\tthis.knownSpeakerReferences = knownSpeakerReferences;\n\t}\n\n\tpublic OpenAiAudioTranscriptionOptions toOptions() {\n\t\tOpenAiAudioTranscriptionOptions.Builder builder = OpenAiAudioTranscriptionOptions.builder()\n\t\t\t.model(this.model)\n\t\t\t.responseFormat(this.responseFormat)\n\t\t\t.prompt(this.prompt)\n\t\t\t.language(this.language)\n\t\t\t.temperature(this.temperature)\n\t\t\t.timestampGranularities(this.timestampGranularities)\n\t\t\t.knownSpeakerNames(this.knownSpeakerNames)\n\t\t\t.knownSpeakerReferences(this.knownSpeakerReferences);\n\t\tif (this.diarizedJsonWorkaroundEnabled != null) {\n\t\t\tbuilder.diarizedJsonWorkaroundEnabled(this.diarizedJsonWorkaroundEnabled);\n\t\t}\n\t\tif (this.chunkingStrategy != null) {\n\t\t\tif (!\"auto\".equalsIgnoreCase(this.chunkingStrategy)) {\n\t\t\t\tthrow new IllegalArgumentException(\n\t\t\t\t\t\t\"Unsupported spring.ai.openai.audio.transcription.chunking-strategy value: '\"\n\t\t\t\t\t\t\t\t+ this.chunkingStrategy\n\t\t\t\t\t\t\t\t+ \"'. Only 'auto' is supported through configuration properties; use \"\n\t\t\t\t\t\t\t\t+ \"OpenAiAudioTranscriptionOptions.Builder#chunkingStrategy(...) programmatically \"\n\t\t\t\t\t\t\t\t+ \"for voice-activity-detection tuning.\");\n\t\t\t}\n\t\t\tbuilder.chunkingStrategy(TranscriptionCreateParams.ChunkingStrategy.ofAuto());\n\t\t}\n\t\treturn builder.build();\n\t}\n\n\tprivate Options options = new Options();\n\n\t@DeprecatedConfigurationProperty(replacement = \"spring.ai.openai.audio.transcription\")\n\t@Deprecated(since = \"2.0.0\", forRemoval = true)\n\tpublic Options getOptions() {\n\t\treturn this.options;\n\t}","sourceCodeStart":154,"sourceCodeEnd":190,"githubUrl":"https://github.com/spring-projects/spring-ai/blob/98a7beda4f29d80a71c5837eb4053b03a93a46f7/auto-configurations/models/spring-ai-autoconfigure-model-openai/src/main/java/org/springframework/ai/model/openai/autoconfigure/OpenAiAudioTranscriptionProperties.java#L154-L190","documentation":"Error \"Unsupported spring.ai.openai.audio.transcription.chunking-strategy value: '<chunkingStrategy>'. Only 'auto' is supported through configuration properties; use OpenAiAudioTranscriptionOptions.Builder#chunkingStrategy(...) programmatically for voice-activity-detection tuning.\" thrown in spring-projects/spring-ai.","triggerScenarios":"Thrown at auto-configurations/models/spring-ai-autoconfigure-model-openai/src/main/java/org/springframework/ai/model/openai/autoconfigure/OpenAiAudioTranscriptionProperties.java:172 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Remove or set chunking-strategy to 'auto' in application properties","Use OpenAiAudioTranscriptionOptions.Builder#chunkingStrategy(...) programmatically for voice-activity-detection tuning","Build the options object directly instead of via the properties converter"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"98a7beda4f29d80a71c5837eb4053b03a93a46f7","analyzedAt":"2026-09-11T14:15:49.441Z","contentChangedAt":"2026-09-11T14:15:49.441Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}