feat(api): Add audio.voices.list sdk

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 44
+configured_endpoints: 45
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/togetherai%2Ftogetherai-e63ffcd87a8f3f9a97e523c95927843e7e4ce8e2788aec58a16313759eb4cee8.yml
 openapi_spec_hash: 2772702ed4747586ac0776fcd227e41f
-config_hash: acbe45d94a426c68447621ec5213405e
+config_hash: 5e9563faf41fd9a91bea97783683bdb2

api.md

@@ -177,6 +177,16 @@ Methods:
 
 - <code title="post /audio/speech">client.Audio.<a href="https://pkg.go.dev/github.com/togethercomputer/together-go#AudioService.New">New</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, body <a href="https://pkg.go.dev/github.com/togethercomputer/together-go">together</a>.<a href="https://pkg.go.dev/github.com/togethercomputer/together-go#AudioNewParams">AudioNewParams</a>) (http.Response, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
 
+## Voices
+
+Response Types:
+
+- <a href="https://pkg.go.dev/github.com/togethercomputer/together-go">together</a>.<a href="https://pkg.go.dev/github.com/togethercomputer/together-go#AudioVoiceListResponse">AudioVoiceListResponse</a>
+
+Methods:
+
+- <code title="get /voices">client.Audio.Voices.<a href="https://pkg.go.dev/github.com/togethercomputer/together-go#AudioVoiceService.List">List</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>) (<a href="https://pkg.go.dev/github.com/togethercomputer/together-go">together</a>.<a href="https://pkg.go.dev/github.com/togethercomputer/together-go#AudioVoiceListResponse">AudioVoiceListResponse</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
+
 ## Transcriptions
 
 Response Types:

audio.go

@@ -23,6 +23,7 @@ import (
 // the [NewAudioService] method instead.
 type AudioService struct {
 	Options        []option.RequestOption
+	Voices         AudioVoiceService
 	Transcriptions AudioTranscriptionService
 	Translations   AudioTranslationService
 }
@@ -33,6 +34,7 @@ type AudioService struct {
 func NewAudioService(opts ...option.RequestOption) (r AudioService) {
 	r = AudioService{}
 	r.Options = opts
+	r.Voices = NewAudioVoiceService(opts...)
 	r.Transcriptions = NewAudioTranscriptionService(opts...)
 	r.Translations = NewAudioTranslationService(opts...)
 	return

audiovoice.go

@@ -0,0 +1,95 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+package together
+
+import (
+	"context"
+	"net/http"
+	"slices"
+
+	"github.com/togethercomputer/together-go/internal/apijson"
+	"github.com/togethercomputer/together-go/internal/requestconfig"
+	"github.com/togethercomputer/together-go/option"
+	"github.com/togethercomputer/together-go/packages/respjson"
+)
+
+// AudioVoiceService contains methods and other services that help with interacting
+// with the together API.
+//
+// Note, unlike clients, this service does not read variables from the environment
+// automatically. You should not instantiate this service directly, and instead use
+// the [NewAudioVoiceService] method instead.
+type AudioVoiceService struct {
+	Options []option.RequestOption
+}
+
+// NewAudioVoiceService generates a new service that applies the given options to
+// each request. These options are applied after the parent client's options (if
+// there is one), and before any request-specific options.
+func NewAudioVoiceService(opts ...option.RequestOption) (r AudioVoiceService) {
+	r = AudioVoiceService{}
+	r.Options = opts
+	return
+}
+
+// Fetch available voices for each model
+func (r *AudioVoiceService) List(ctx context.Context, opts ...option.RequestOption) (res *AudioVoiceListResponse, err error) {
+	opts = slices.Concat(r.Options, opts)
+	path := "voices"
+	err = requestconfig.ExecuteNewRequest(ctx, http.MethodGet, path, nil, &res, opts...)
+	return
+}
+
+// Response containing a list of models and their available voices.
+type AudioVoiceListResponse struct {
+	Data []AudioVoiceListResponseData `json:"data,required"`
+	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
+	JSON struct {
+		Data        respjson.Field
+		ExtraFields map[string]respjson.Field
+		raw         string
+	} `json:"-"`
+}
+
+// Returns the unmodified JSON received from the API
+func (r AudioVoiceListResponse) RawJSON() string { return r.JSON.raw }
+func (r *AudioVoiceListResponse) UnmarshalJSON(data []byte) error {
+	return apijson.UnmarshalRoot(data, r)
+}
+
+// Represents a model with its available voices.
+type AudioVoiceListResponseData struct {
+	Model  string                            `json:"model,required"`
+	Voices []AudioVoiceListResponseDataVoice `json:"voices,required"`
+	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
+	JSON struct {
+		Model       respjson.Field
+		Voices      respjson.Field
+		ExtraFields map[string]respjson.Field
+		raw         string
+	} `json:"-"`
+}
+
+// Returns the unmodified JSON received from the API
+func (r AudioVoiceListResponseData) RawJSON() string { return r.JSON.raw }
+func (r *AudioVoiceListResponseData) UnmarshalJSON(data []byte) error {
+	return apijson.UnmarshalRoot(data, r)
+}
+
+type AudioVoiceListResponseDataVoice struct {
+	ID   string `json:"id,required"`
+	Name string `json:"name,required"`
+	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
+	JSON struct {
+		ID          respjson.Field
+		Name        respjson.Field
+		ExtraFields map[string]respjson.Field
+		raw         string
+	} `json:"-"`
+}
+
+// Returns the unmodified JSON received from the API
+func (r AudioVoiceListResponseDataVoice) RawJSON() string { return r.JSON.raw }
+func (r *AudioVoiceListResponseDataVoice) UnmarshalJSON(data []byte) error {
+	return apijson.UnmarshalRoot(data, r)
+}

audiovoice_test.go

@@ -0,0 +1,36 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+package together_test
+
+import (
+	"context"
+	"errors"
+	"os"
+	"testing"
+
+	"github.com/togethercomputer/together-go"
+	"github.com/togethercomputer/together-go/internal/testutil"
+	"github.com/togethercomputer/together-go/option"
+)
+
+func TestAudioVoiceList(t *testing.T) {
+	baseURL := "http://localhost:4010"
+	if envURL, ok := os.LookupEnv("TEST_API_BASE_URL"); ok {
+		baseURL = envURL
+	}
+	if !testutil.CheckTestServer(t, baseURL) {
+		return
+	}
+	client := together.NewClient(
+		option.WithBaseURL(baseURL),
+		option.WithAPIKey("My API Key"),
+	)
+	_, err := client.Audio.Voices.List(context.TODO())
+	if err != nil {
+		var apierr *together.Error
+		if errors.As(err, &apierr) {
+			t.Log(string(apierr.DumpRequest(true)))
+		}
+		t.Fatalf("err should be nil: %s", err.Error())
+	}
+}