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

@@ -164,6 +164,16 @@ Methods:
 
 - <code title="post /audio/speech">client.audio.<a href="./src/resources/audio/audio.ts">create</a>({ ...params }) -> Response</code>
 
+## Voices
+
+Types:
+
+- <code><a href="./src/resources/audio/voices.ts">VoiceListResponse</a></code>
+
+Methods:
+
+- <code title="get /voices">client.audio.voices.<a href="./src/resources/audio/voices.ts">list</a>() -> VoiceListResponse</code>
+
 ## Transcriptions
 
 Types:

src/resources/audio/audio.ts

@@ -6,12 +6,15 @@ import * as TranscriptionsAPI from './transcriptions';
 import { TranscriptionCreateParams, TranscriptionCreateResponse, Transcriptions } from './transcriptions';
 import * as TranslationsAPI from './translations';
 import { TranslationCreateParams, TranslationCreateResponse, Translations } from './translations';
+import * as VoicesAPI from './voices';
+import { VoiceListResponse, Voices } from './voices';
 import { APIPromise } from '../../core/api-promise';
 import { Stream } from '../../core/streaming';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 
 export class Audio extends APIResource {
+  voices: VoicesAPI.Voices = new VoicesAPI.Voices(this._client);
   transcriptions: TranscriptionsAPI.Transcriptions = new TranscriptionsAPI.Transcriptions(this._client);
   translations: TranslationsAPI.Translations = new TranslationsAPI.Translations(this._client);
 
@@ -175,6 +178,7 @@ export interface AudioCreateParamsStreaming extends AudioCreateParamsBase {
   stream: true;
 }
 
+Audio.Voices = Voices;
 Audio.Transcriptions = Transcriptions;
 Audio.Translations = Translations;
 
@@ -187,6 +191,8 @@ export declare namespace Audio {
     type AudioCreateParamsStreaming as AudioCreateParamsStreaming,
   };
 
+  export { Voices as Voices, type VoiceListResponse as VoiceListResponse };
+
   export {
     Transcriptions as Transcriptions,
     type TranscriptionCreateResponse as TranscriptionCreateResponse,

src/resources/audio/index.ts

@@ -14,3 +14,4 @@ export {
   type TranscriptionCreateParams,
 } from './transcriptions';
 export { Translations, type TranslationCreateResponse, type TranslationCreateParams } from './translations';
+export { Voices, type VoiceListResponse } from './voices';

src/resources/audio/voices.ts

@@ -0,0 +1,49 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+
+export class Voices extends APIResource {
+  /**
+   * Fetch available voices for each model
+   *
+   * @example
+   * ```ts
+   * const voices = await client.audio.voices.list();
+   * ```
+   */
+  list(options?: RequestOptions): APIPromise<VoiceListResponse> {
+    return this._client.get('/voices', options);
+  }
+}
+
+/**
+ * Response containing a list of models and their available voices.
+ */
+export interface VoiceListResponse {
+  data: Array<VoiceListResponse.Data>;
+}
+
+export namespace VoiceListResponse {
+  /**
+   * Represents a model with its available voices.
+   */
+  export interface Data {
+    model: string;
+
+    voices: Array<Data.Voice>;
+  }
+
+  export namespace Data {
+    export interface Voice {
+      id: string;
+
+      name: string;
+    }
+  }
+}
+
+export declare namespace Voices {
+  export { type VoiceListResponse as VoiceListResponse };
+}

tests/api-resources/audio/voices.test.ts

@@ -0,0 +1,21 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import Together from 'together-ai';
+
+const client = new Together({
+  apiKey: 'My API Key',
+  baseURL: process.env['TEST_API_BASE_URL'] ?? 'http://127.0.0.1:4010',
+});
+
+describe('resource voices', () => {
+  test('list', async () => {
+    const responsePromise = client.audio.voices.list();
+    const rawResponse = await responsePromise.asResponse();
+    expect(rawResponse).toBeInstanceOf(Response);
+    const response = await responsePromise;
+    expect(response).not.toBeInstanceOf(Response);
+    const dataAndResponse = await responsePromise.withResponse();
+    expect(dataAndResponse.data).toBe(response);
+    expect(dataAndResponse.response).toBe(rawResponse);
+  });
+});