Skip to content

Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.

13.1 KB
Raw Blame
package asr

import (
	"context"
	"encoding/json"
	"io"
	"mime"
	"mime/multipart"
	"net/http"
	"net/http/httptest"
	"sync/atomic"
	"testing"

	modelruntime "github.com/Tencent/WeKnora/internal/models/runtime"
	"github.com/Tencent/WeKnora/internal/types"
	secutils "github.com/Tencent/WeKnora/internal/utils"
	"github.com/stretchr/testify/assert"
	"github.com/stretchr/testify/require"
)

func allowLoopback(t *testing.T) {
	t.Helper()
	t.Setenv("SSRF_WHITELIST", "127.0.0.1")
	secutils.ResetSSRFWhitelistForTest()
	t.Cleanup(secutils.ResetSSRFWhitelistForTest)
}

type form struct {
	path     string
	auth     string
	fields   map[string]string
	fileName string
	language string // the language request header
	// body is set instead of fields when the request was JSON: the
	// chat-served recognisers take the audio as a data URI.
	body map[string]any
}

// upstream records the form it receives and answers the documented json
// shape, adding a segment when verbose_json was asked for.
func upstream(t *testing.T) (string, *form, *atomic.Int32) {
	t.Helper()
	allowLoopback(t)
	got := &form{fields: map[string]string{}}
	calls := &atomic.Int32{}
	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		calls.Add(1)
		got.path, got.auth, got.language = r.URL.Path, r.Header.Get("Authorization"), r.Header.Get("language")
		mediaType, params, err := mime.ParseMediaType(r.Header.Get("Content-Type"))
		require.NoError(t, err)
		if mediaType == "application/json" {
			require.NoError(t, json.NewDecoder(r.Body).Decode(&got.body))
			_, _ = w.Write([]byte(`{"choices":[{"message":{"role":"assistant","content":" hello "}}]}`))
			return
		}
		reader := multipart.NewReader(r.Body, params["boundary"])
		for {
			part, err := reader.NextPart()
			if err == io.EOF {
				break
			}
			require.NoError(t, err)
			data, _ := io.ReadAll(part)
			if part.FormName() == "file" {
				got.fileName = part.FileName()
				continue
			}
			got.fields[part.FormName()] = string(data)
		}
		if got.fields["response_format"] == "verbose_json" {
			_, _ = w.Write([]byte(`{"text":" hello ","segments":[{"start":0,"end":1.5,"text":" hello "}]}`))
			return
		}
		_, _ = w.Write([]byte(`{"text":" hello "}`))
	}))
	t.Cleanup(server.Close)
	return server.URL, got, calls
}

// TestTranscriptionWireFormatPerVendor pins the form each ASR vendor is sent.
// response_format appears only where the vendor documents it for that model:
// the pre-catalog client sent verbose_json to every one of them, which
// gpt-4o-transcribe rejects ("the only supported format is json") and which
// vox-box's FunASR backend answers with an undecodable bare string.
func TestTranscriptionWireFormatPerVendor(t *testing.T) {
	chatAudio := func(model string) map[string]any {
		return map[string]any{
			"model": model,
			"messages": []any{map[string]any{
				"role": "user",
				"content": []any{map[string]any{
					"type":        "input_audio",
					"input_audio": map[string]any{"data": "data:audio/wav;base64,UklGRg=="},
				}},
			}},
		}
	}
	cases := []struct {
		name, provider, model, base string
		wantPath                    string
		wantFields                  map[string]string
		wantBody                    map[string]any
		wantSegments                int
	}{
		{
			name: "openai whisper-1 serves segments", provider: "openai", model: "whisper-1", base: "/v1",
			wantPath:     "/v1/audio/transcriptions",
			wantFields:   map[string]string{"model": "whisper-1", "response_format": "verbose_json"},
			wantSegments: 1,
		},
		{
			name: "openai gpt-4o-transcribe accepts only json", provider: "openai", model: "gpt-4o-transcribe",
			base: "/v1", wantPath: "/v1/audio/transcriptions",
			wantFields: map[string]string{"model": "gpt-4o-transcribe"},
		},
		{
			name: "openai model not yet in the catalog", provider: "openai", model: "gpt-5-transcribe",
			base: "/v1", wantPath: "/v1/audio/transcriptions",
			wantFields: map[string]string{"model": "gpt-5-transcribe"},
		},
		{
			name: "siliconflow documents file and model only", provider: "siliconflow",
			model: "FunAudioLLM/SenseVoiceSmall", base: "/v1", wantPath: "/v1/audio/transcriptions",
			wantFields: map[string]string{"model": "FunAudioLLM/SenseVoiceSmall"},
		},
		{
			name: "gpustack stays on json for its FunASR backend", provider: "gpustack",
			model: "SenseVoiceSmall", base: "/v1", wantPath: "/v1/audio/transcriptions",
			wantFields: map[string]string{"model": "SenseVoiceSmall"},
		},
		{
			name: "generic stays on json", provider: "generic", model: "whisper-large-v3",
			base: "/v1", wantPath: "/v1/audio/transcriptions",
			wantFields: map[string]string{"model": "whisper-large-v3"},
		},
		{
			name: "zhipu glm-asr on the OpenAI shape", provider: "zhipu", model: "glm-asr-2512",
			base: "/api/paas/v4", wantPath: "/api/paas/v4/audio/transcriptions",
			wantFields: map[string]string{"model": "glm-asr-2512"},
		},
		{
			name: "minimax on its own path", provider: "minimax", model: "asr-1.0",
			base: "/v1", wantPath: "/v1/speech_to_text",
			wantFields: map[string]string{"model": "asr-1.0"},
		},
		{
			name: "openrouter", provider: "openrouter", model: "openai/whisper-large-v3",
			base: "/api/v1", wantPath: "/api/v1/audio/transcriptions",
			wantFields: map[string]string{"model": "openai/whisper-large-v3"},
		},
		{
			name: "requesty whisper-1 serves segments", provider: "requesty", model: "openai/whisper-1",
			base: "/v1", wantPath: "/v1/audio/transcriptions",
			wantFields:   map[string]string{"model": "openai/whisper-1", "response_format": "verbose_json"},
			wantSegments: 1,
		},
		{
			name: "litellm proxy", provider: "litellm", model: "whisper",
			base: "/v1", wantPath: "/v1/audio/transcriptions",
			wantFields: map[string]string{"model": "whisper"},
		},
		{
			name: "aliyun qwen3-asr-flash is served on chat", provider: "aliyun", model: "qwen3-asr-flash",
			base: "/compatible-mode/v1", wantPath: "/compatible-mode/v1/chat/completions",
			wantBody: chatAudio("qwen3-asr-flash"),
		},
		{
			name: "mimo asr is served on chat", provider: "mimo", model: "mimo-v2.5-asr",
			base: "/v1", wantPath: "/v1/chat/completions",
			wantBody: chatAudio("mimo-v2.5-asr"),
		},
	}
	for _, tc := range cases {
		t.Run(tc.name, func(t *testing.T) {
			url, got, _ := upstream(t)
			a, err := NewASR(&Config{
				Source: types.ModelSourceRemote, Provider: tc.provider, BaseURL: url + tc.base,
				ModelName: tc.model, APIKey: "k",
			})
			require.NoError(t, err)
			out, err := a.Transcribe(context.Background(), []byte("RIFF"), "meeting.wav")
			require.NoError(t, err)

			assert.Equal(t, tc.wantPath, got.path)
			assert.Equal(t, "Bearer k", got.auth)
			if tc.wantBody != nil {
				assert.Equal(t, tc.wantBody, got.body)
			} else {
				assert.Equal(t, tc.wantFields, got.fields)
				assert.Equal(t, "meeting.wav", got.fileName)
			}
			assert.Equal(t, "hello", out.Text)
			assert.Len(t, out.Segments, tc.wantSegments)
		})
	}
}

// A file over the documented ceiling is refused before it is uploaded: the
// vendor would reject it anyway, after the whole upload.
func TestOversizedAudioIsRefusedBeforeUpload(t *testing.T) {
	url, _, calls := upstream(t)
	a, err := NewASR(&Config{
		Source: types.ModelSourceRemote, Provider: "openai", BaseURL: url + "/v1",
		ModelName: "whisper-1", APIKey: "k",
	})
	require.NoError(t, err)

	_, err = a.Transcribe(context.Background(), make([]byte, 25<<20+1), "long.mp3")
	require.Error(t, err)
	assert.Contains(t, err.Error(), "at most 25 MB")
	assert.Zero(t, calls.Load(), "nothing should have been sent")

	_, err = a.Transcribe(context.Background(), make([]byte, 25<<20), "exactly.mp3")
	require.NoError(t, err, "the ceiling itself is allowed")
}

// The chat-served recognisers cap the data URI as sent at 10 MB, prefix
// included, so three quarters of 10 MB of audio is already too much.
func TestChatServedCeilingCountsTheWholeDataURI(t *testing.T) {
	url, _, calls := upstream(t)
	a, err := NewASR(&Config{
		Source: types.ModelSourceRemote, Provider: "aliyun", BaseURL: url + "/compatible-mode/v1",
		ModelName: "qwen3-asr-flash", APIKey: "k",
	})
	require.NoError(t, err)

	_, err = a.Transcribe(context.Background(), make([]byte, 10<<20*3/4), "long.wav")
	require.Error(t, err)
	assert.Zero(t, calls.Load())

	prefix := len("data:audio/wav;base64,")
	_, err = a.Transcribe(context.Background(), make([]byte, (10<<20-prefix)/4*3), "fits.wav")
	require.NoError(t, err)
}

// Only qwen3-asr-flash takes the audio in the request. Alibaba's other
// recognition models want a public URL or an asynchronous task, so a row
// naming one is refused with the reason rather than sent a chat request.
func TestAlibabaRecognitionModelsOtherThanQwenASRFlashAreRefused(t *testing.T) {
	_, err := NewASR(&Config{
		Source: types.ModelSourceRemote, Provider: "aliyun",
		BaseURL: "https://dashscope.aliyuncs.com/compatible-mode/v1", ModelName: "paraformer-v2", APIKey: "k",
	})
	require.Error(t, err)
	assert.Contains(t, err.Error(), "public file URL")
}

// A vendor that does not declare speech recognition is not trusted with it.
// Azure's Endpoint hook still knows a transcription path, but nobody has
// verified it; a row that names Azure is refused, and a row that names no
// vendor gets what the pre-catalog client sent: the OpenAI shape at its URL.
func TestVendorsWithoutASRAreNotRoutedThroughTheirHooks(t *testing.T) {
	_, err := NewASR(&Config{
		Source: types.ModelSourceRemote, Provider: "azure_openai",
		BaseURL: "https://example.openai.azure.com", ModelName: "whisper", APIKey: "k",
	})
	require.Error(t, err)

	// Detection matches URL patterns as substrings, so a path carrying Azure's
	// host detects as Azure while the request still reaches the test server.
	url, got, _ := upstream(t)
	base := url + "/openai.azure.com/v1"
	require.Equal(t, "azure_openai", modelruntime.DetectByURL(base))
	a, err := NewASR(&Config{
		Source: types.ModelSourceRemote, BaseURL: base, ModelName: "whisper", APIKey: "k",
	})
	require.NoError(t, err)
	_, err = a.Transcribe(context.Background(), []byte("RIFF"), "a.wav")
	require.NoError(t, err)
	assert.Equal(t, "/openai.azure.com/v1/audio/transcriptions", got.path, "not Azure's /openai/v1 path")
	assert.Equal(t, "Bearer k", got.auth, "not Azure's api-key header")
}

// A format the vendor does not list is refused before upload.
func TestUndocumentedFormatIsRefusedBeforeUpload(t *testing.T) {
	url, _, calls := upstream(t)
	a, err := NewASR(&Config{
		Source: types.ModelSourceRemote, Provider: "zhipu", BaseURL: url + "/api/paas/v4",
		ModelName: "glm-asr-2512", APIKey: "k",
	})
	require.NoError(t, err)
	_, err = a.Transcribe(context.Background(), []byte("x"), "memo.m4a")
	require.Error(t, err)
	assert.Contains(t, err.Error(), "wav/mp3")
	assert.Zero(t, calls.Load())
}

// The knowledge base's language hint reaches each vendor where its reference
// puts it, and nowhere for a vendor that documents none.
func TestLanguageHintGoesWhereEachVendorDocumentsIt(t *testing.T) {
	for _, tc := range []struct {
		name, provider, model, base string
		check                       func(t *testing.T, got *form)
	}{
		{"openai form field", "openai", "whisper-1", "/v1", func(t *testing.T, got *form) {
			assert.Equal(t, "zh", got.fields["language"])
			assert.Empty(t, got.language)
		}},
		{"minimax header", "minimax", "asr-1.0", "/v1", func(t *testing.T, got *form) {
			assert.Equal(t, "zh", got.language)
			assert.NotContains(t, got.fields, "language")
		}},
		{"aliyun asr_options", "aliyun", "qwen3-asr-flash", "/compatible-mode/v1", func(t *testing.T, got *form) {
			assert.Equal(t, map[string]any{"language": "zh"}, got.body["asr_options"])
		}},
		{
			"siliconflow documents none", "siliconflow", "FunAudioLLM/SenseVoiceSmall", "/v1",
			func(t *testing.T, got *form) {
				assert.NotContains(t, got.fields, "language")
				assert.Empty(t, got.language)
			},
		},
	} {
		t.Run(tc.name, func(t *testing.T) {
			url, got, _ := upstream(t)
			a, err := NewASR(&Config{
				Source: types.ModelSourceRemote, Provider: tc.provider, BaseURL: url + tc.base,
				ModelName: tc.model, APIKey: "k",
			})
			require.NoError(t, err)
			_, err = a.Transcribe(WithLanguage(context.Background(), "zh"), []byte("RIFF"), "a.wav")
			require.NoError(t, err)
			tc.check(t, got)
		})
	}

	// "auto" is every vendor's default and is not sent.
	url, got, _ := upstream(t)
	a, err := NewASR(&Config{
		Source: types.ModelSourceRemote, Provider: "openai", BaseURL: url + "/v1", ModelName: "whisper-1", APIKey: "k",
	})
	require.NoError(t, err)
	_, err = a.Transcribe(WithLanguage(context.Background(), "auto"), []byte("RIFF"), "a.wav")
	require.NoError(t, err)
	assert.NotContains(t, got.fields, "language")
}

func TestEmptyAudioIsAnError(t *testing.T) {
	url, _, calls := upstream(t)
	a, err := NewASR(&Config{Source: types.ModelSourceRemote, Provider: "generic", BaseURL: url, ModelName: "m"})
	require.NoError(t, err)
	_, err = a.Transcribe(context.Background(), nil, "a.wav")
	assert.Error(t, err)
	assert.Zero(t, calls.Load())
}

func TestInternalBaseURLIsRefused(t *testing.T) {
	t.Setenv("SSRF_WHITELIST", "")
	secutils.ResetSSRFWhitelistForTest()
	t.Cleanup(secutils.ResetSSRFWhitelistForTest)
	_, err := NewASR(&Config{
		Source: types.ModelSourceRemote, Provider: "generic",
		BaseURL: "http://169.254.169.254/latest/meta-data/", ModelName: "asr-test",
	})
	assert.Error(t, err)
}