release: 0.3.0 (#109)

* feat(files): add support for string alternative to file upload type

* release: 0.3.0

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.2.0"
+  ".": "0.3.0"
 }

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.3.0 (2025-12-16)
+
+Full Changelog: [v0.2.0...v0.3.0](https://github.com/togethercomputer/together-go/compare/v0.2.0...v0.3.0)
+
+### Features
+
+* **files:** add support for string alternative to file upload type ([07c6a44](https://github.com/togethercomputer/together-go/commit/07c6a44da0e74c3331698b517cc5e26aec5461e4))
+
 ## 0.2.0 (2025-12-15)
 
 Full Changelog: [v0.1.0...v0.2.0](https://github.com/togethercomputer/together-go/compare/v0.1.0...v0.2.0)

README.md

@@ -28,7 +28,7 @@ Or to pin the version:
 <!-- x-release-please-start-version -->
 
 ```sh
-go get -u 'github.com/togethercomputer/together-go@v0.2.0'
+go get -u 'github.com/togethercomputer/together-go@v0.3.0'
 ```
 
 <!-- x-release-please-end -->

audiotranscription.go

@@ -277,8 +277,9 @@ func (r *AudioTranscriptionNewResponseAudioTranscriptionVerboseJsonResponseWord)
 }
 
 type AudioTranscriptionNewParams struct {
-	// Audio file to transcribe
-	File io.Reader `json:"file,omitzero,required" format:"binary"`
+	// Audio file upload or public HTTP/HTTPS URL. Supported formats .wav, .mp3, .m4a,
+	// .webm, .flac.
+	File AudioTranscriptionNewParamsFileUnion `json:"file,omitzero,required" format:"binary"`
 	// Whether to enable speaker diarization. When enabled, you will get the speaker id
 	// for each word in the transcription. In the response, in the words array, you
 	// will get the speaker id for each word. In addition, we also return the
@@ -336,6 +337,31 @@ func (r AudioTranscriptionNewParams) MarshalMultipart() (data []byte, contentTyp
 	return buf.Bytes(), writer.FormDataContentType(), nil
 }
 
+// Only one field can be non-zero.
+//
+// Use [param.IsOmitted] to confirm if a field is set.
+type AudioTranscriptionNewParamsFileUnion struct {
+	OfFile   io.Reader         `json:",omitzero,inline"`
+	OfString param.Opt[string] `json:",omitzero,inline"`
+	paramUnion
+}
+
+func (u AudioTranscriptionNewParamsFileUnion) MarshalJSON() ([]byte, error) {
+	return param.MarshalUnion(u, u.OfFile, u.OfString)
+}
+func (u *AudioTranscriptionNewParamsFileUnion) UnmarshalJSON(data []byte) error {
+	return apijson.UnmarshalRoot(data, u)
+}
+
+func (u *AudioTranscriptionNewParamsFileUnion) asAny() any {
+	if !param.IsOmitted(u.OfFile) {
+		return &u.OfFile
+	} else if !param.IsOmitted(u.OfString) {
+		return &u.OfString.Value
+	}
+	return nil
+}
+
 // Model to use for transcription
 type AudioTranscriptionNewParamsModel string
 

audiotranscription_test.go

@@ -28,7 +28,9 @@ func TestAudioTranscriptionNewWithOptionalParams(t *testing.T) {
 		option.WithAPIKey("My API Key"),
 	)
 	_, err := client.Audio.Transcriptions.New(context.TODO(), together.AudioTranscriptionNewParams{
-		File:           io.Reader(bytes.NewBuffer([]byte("some file contents"))),
+		File: together.AudioTranscriptionNewParamsFileUnion{
+			OfFile: io.Reader(bytes.NewBuffer([]byte("some file contents"))),
+		},
 		Diarize:        together.Bool(true),
 		Language:       together.String("en"),
 		MaxSpeakers:    together.Int(0),

audiotranslation.go

@@ -206,8 +206,9 @@ func (r *AudioTranslationNewResponseAudioTranslationVerboseJsonResponseWord) Unm
 }
 
 type AudioTranslationNewParams struct {
-	// Audio file to translate
-	File io.Reader `json:"file,omitzero,required" format:"binary"`
+	// Audio file upload or public HTTP/HTTPS URL. Supported formats .wav, .mp3, .m4a,
+	// .webm, .flac.
+	File AudioTranslationNewParamsFileUnion `json:"file,omitzero,required" format:"binary"`
 	// Target output language. Optional ISO 639-1 language code. If omitted, language
 	// is set to English.
 	Language param.Opt[string] `json:"language,omitzero"`
@@ -248,6 +249,31 @@ func (r AudioTranslationNewParams) MarshalMultipart() (data []byte, contentType
 	return buf.Bytes(), writer.FormDataContentType(), nil
 }
 
+// Only one field can be non-zero.
+//
+// Use [param.IsOmitted] to confirm if a field is set.
+type AudioTranslationNewParamsFileUnion struct {
+	OfFile   io.Reader         `json:",omitzero,inline"`
+	OfString param.Opt[string] `json:",omitzero,inline"`
+	paramUnion
+}
+
+func (u AudioTranslationNewParamsFileUnion) MarshalJSON() ([]byte, error) {
+	return param.MarshalUnion(u, u.OfFile, u.OfString)
+}
+func (u *AudioTranslationNewParamsFileUnion) UnmarshalJSON(data []byte) error {
+	return apijson.UnmarshalRoot(data, u)
+}
+
+func (u *AudioTranslationNewParamsFileUnion) asAny() any {
+	if !param.IsOmitted(u.OfFile) {
+		return &u.OfFile
+	} else if !param.IsOmitted(u.OfString) {
+		return &u.OfString.Value
+	}
+	return nil
+}
+
 // Model to use for translation
 type AudioTranslationNewParamsModel string
 

audiotranslation_test.go

@@ -28,7 +28,9 @@ func TestAudioTranslationNewWithOptionalParams(t *testing.T) {
 		option.WithAPIKey("My API Key"),
 	)
 	_, err := client.Audio.Translations.New(context.TODO(), together.AudioTranslationNewParams{
-		File:           io.Reader(bytes.NewBuffer([]byte("some file contents"))),
+		File: together.AudioTranslationNewParamsFileUnion{
+			OfFile: io.Reader(bytes.NewBuffer([]byte("some file contents"))),
+		},
 		Language:       together.String("en"),
 		Model:          together.AudioTranslationNewParamsModelOpenAIWhisperLargeV3,
 		Prompt:         together.String("prompt"),

internal/version.go

@@ -2,4 +2,4 @@
 
 package internal
 
-const PackageVersion = "0.2.0" // x-release-please-version
+const PackageVersion = "0.3.0" // x-release-please-version