chore(api): Ensure file.upload API remains in codebase after stainless sync

Author: blainekasten

README.md

@@ -77,35 +77,6 @@ const chatCompletion: Together.Chat.ChatCompletion = await client.chat.completio
 
 Documentation for each method, request param, and response field are available in docstrings and will appear on hover in most modern editors.
 
-## File uploads
-
-Request parameters that correspond to file uploads can be passed in many different forms:
-
-- `File` (or an object with the same structure)
-- a `fetch` `Response` (or an object with the same structure)
-- an `fs.ReadStream`
-- the return value of our `toFile` helper
-
-```ts
-import fs from 'fs';
-import Together, { toFile } from 'together-ai';
-
-const client = new Together();
-
-// If you have access to Node `fs` we recommend using `fs.createReadStream()`:
-await client.audio.transcriptions.create({ file: fs.createReadStream('/path/to/file') });
-
-// Or if you have the web `File` API you can pass a `File` instance:
-await client.audio.transcriptions.create({ file: new File(['my bytes'], 'file') });
-
-// You can also pass a `fetch` `Response`:
-await client.audio.transcriptions.create({ file: await fetch('https://somesite/file') });
-
-// Finally, if none of the above are convenient, you can use our `toFile` helper:
-await client.audio.transcriptions.create({ file: await toFile(Buffer.from('my bytes'), 'file') });
-await client.audio.transcriptions.create({ file: await toFile(new Uint8Array([0, 1, 2]), 'file') });
-```
-
 ## Handling errors
 
 When the library is unable to connect to the API,

api.md

@@ -64,6 +64,7 @@ Methods:
 - <code title="get /files">client.files.<a href="./src/resources/files.ts">list</a>() -> FileListResponse</code>
 - <code title="delete /files/{id}">client.files.<a href="./src/resources/files.ts">delete</a>(id) -> FileDeleteResponse</code>
 - <code title="get /files/{id}/content">client.files.<a href="./src/resources/files.ts">content</a>(id) -> Response</code>
+- <code title="post /files/upload">client.files.<a href="./src/resources/files.ts">upload</a>({ ...params }) -> FileRetrieveResponse</code>
 
 # FineTuning
 

src/resources/files.ts

@@ -6,6 +6,7 @@ import { APIPromise } from '../core/api-promise';
 import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
+import { upload } from '../lib/upload';
 
 export class Files extends APIResource {
   /**
@@ -62,6 +63,14 @@ export class Files extends APIResource {
       __binaryResponse: true,
     });
   }
+
+  /**
+   * Upload a file.
+   * CUSTOM CODE. DO NOT LET STAINLESS REMOVE.
+   */
+  upload(file: string, purpose: FilePurpose, check: boolean = true): APIPromise<FileRetrieveResponse> {
+    return upload(this._client, file, purpose, check);
+  }
 }
 
 export interface FileObject {