Files
ai/controllers/speech_to_text.go
zeekayandHanzo Dev 62b5256d2f util: uuid.NewString() is the home for a UUID; drop the two aliases
util.GenerateId() and util.GenerateUUID() were both `return uuid.NewString()`
-- two names for one fact, in the same file, 45 call sites between them
(9 and 36). A third copy of GenerateId lived in hanzoai/vm.

Wrapping a function to rename it buys nothing and costs a second place to
look, so both are deleted and every call site now says uuid.NewString().
The home is github.com/google/uuid, which this module already required
directly; with the wrappers gone there is nothing left for another repo to
duplicate.

Mechanical and behaviour-preserving: uuid.NewString() is literally what
both wrappers returned (GenerateUUID's uuid.New().String() is NewString's
own definition).

Failing-test set unchanged: object/TestTranslateArticle fails on
origin/main before this change and after it.

Co-authored-by: Hanzo Dev <[email protected]>
2026-08-02 12:50:01 -07:00

120 lines
3.6 KiB
Go

// Copyright 2023-2025 Hanzo AI Inc. All Rights Reserved.
// Portions Copyright 2025 The OpenAgent Authors. All Rights Reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package controllers
import (
"context"
"fmt"
"time"
"github.com/google/uuid"
"github.com/hanzoai/ai/object"
)
// ProcessSpeechToText
// @Title ProcessSpeechToText
// @Tag STT API
// @Description convert speech to text
// @Param audio formData file true "The audio file to convert to text"
// @Param storeId formData string true "The store ID"
// @Success 200 {object} controllers.SpeechToTextResponse The transcribed text
// @router /process-speech-to-text [post]
func (c *ApiController) ProcessSpeechToText() {
// Get parameters from form data
storeId := c.GetString("storeId")
if storeId == "" {
c.ResponseError(c.T("stt:Missing required parameter: storeId"))
return
}
// Get the audio audioFile from the request
audioFile, _, err := c.GetFile("audio")
if err != nil {
c.ResponseError(fmt.Sprintf("Error getting audio audioFile: %s", err.Error()))
return
}
defer audioFile.Close()
store, err := object.GetStore(storeId)
if err != nil {
c.ResponseError(err.Error())
return
}
if store == nil {
c.ResponseError(fmt.Sprintf("The store: %s is not found", storeId))
return
}
// Get STT provider
provider, err := store.GetSpeechToTextProvider()
if err != nil {
c.ResponseError(err.Error())
return
}
if provider == nil {
c.ResponseError(fmt.Sprintf("The speech-to-text provider for store: %s is not found", store.GetId()))
return
}
// Get provider implementation
providerObj, err := provider.GetSpeechToTextProvider(c.GetAcceptLanguage())
if err != nil {
c.ResponseError(err.Error())
return
}
// Process the audio data and get the transcription
ctx := context.Background()
startTime := time.Now().UTC()
text, _, err := providerObj.ProcessAudio(audioFile, ctx, c.GetAcceptLanguage())
c.recordLegacySTTUsage(store, provider, startTime, err)
if err != nil {
c.ResponseError(err.Error())
return
}
// Return the transcribed text
c.ResponseOk(text)
}
// recordLegacySTTUsage traces the legacy store-bound STT handler into the one
// usage/o11y plane. The provider result exposes no price surface here, so the
// row bills 0 and is flagged Unpriced — the paid transcription traffic becomes
// visible (and errors stay visible: recordTrace is unconditional) instead of
// invisible. Pricing is the legacy-price rip, tracked separately.
func (c *ApiController) recordLegacySTTUsage(store *object.Store, provider *object.Provider, startTime time.Time, callErr error) {
if store == nil || provider == nil {
return
}
status, errMsg := "success", ""
if callErr != nil {
status, errMsg = "error", callErr.Error()
}
rec := &usageRecord{
Owner: store.Owner,
Organization: store.Owner,
Model: provider.Name,
Provider: provider.Name,
Currency: "USD",
Status: status,
ErrorMsg: errMsg,
Unpriced: true,
ClientIP: c.Ctx.Request.RemoteAddr,
RequestID: uuid.NewString(),
}
recordUsage(rec)
recordTrace(c.Ctx.Request.Context(), rec, startTime)
}