Skip to content

Documentation Mismatch: vad_filter Parameter Type Should Be Boolean #22927

Closed
@Yu-zk

Description

@Yu-zk

Existing documentation URL(s)

What changes are you suggesting?

I've encountered an issue with the vad_filter parameter in the whisper-large-v3-turbo API. The doc lists vad_filter as a string with a default value of "false". Since approximately 2025-06-05 15:52 UTC, setting vad_filter to the string "true" in the whisper-large-v3-turbo API results in the following error:
{ "errors": [ { "message": "AiError: Bad input: Error: Type mismatch of '/vad_filter', 'boolean' not in 'string' (027e9ecc-8141-4fee-b1e1-e37440746c8b)", "code": 5006 } ], "success": false, "result": {}, "messages": [] }

This indicates that the API now expects a boolean value for vad_filter. Changing the parameter to the boolean true resolves the issue.

However, the documentation still lists vad_filter as a string with a default value of "false". To prevent confusion and ensure consistency, the documentation should be updated to reflect that vad_filter is of type boolean, with a default value of false.

Additionally, was this change communicated to users in advance? A sudden change in parameter type without prior notification can lead to unexpected errors in production environments.

Additional information

No response

Metadata

Metadata

Labels

content:editRequest for content editsdocumentationDocumentation editsproduct:workers-aiWorkers AI: https://developers.cloudflare.com/workers-ai/

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions