SDK Readme Improvements (#530)

* initial improvements

* fix mdlint errors

* more more lint fixes

* more updates

* more updates

* additional updates

* simplifies example

* final updates

* Update README.md

Co-authored-by: Naomi <accounts+github@nhcarrigan.com>

---------

Co-authored-by: Naomi <accounts+github@nhcarrigan.com>

Author: jpvajda

README.md

@@ -0,0 +1,61 @@
+# Copyright 2023-2024 Deepgram SDK contributors. All Rights Reserved.
+# Use of this source code is governed by a MIT license that can be found in the LICENSE file.
+# SPDX-License-Identifier: MIT
+
+import os
+from dotenv import load_dotenv
+import logging
+from deepgram.utils import verboselogs
+from datetime import datetime
+import httpx
+
+from deepgram import (
+    DeepgramClient,
+    DeepgramClientOptions,
+    PrerecordedOptions,
+    UrlSource,
+)
+
+load_dotenv()
+
+# URL to the audio file to transcribe
+AUDIO_URL = "https://dpgr.am/spacewalk.wav"  # Replace with your audio URL
+
+
+def main():
+    try:
+        # STEP 1 Create a Deepgram client using the API key in the environment variables
+        config: DeepgramClientOptions = DeepgramClientOptions(
+            verbose=verboselogs.SPAM,
+        )
+        deepgram: DeepgramClient = DeepgramClient("", config)
+        # OR use defaults
+        # deepgram: DeepgramClient = DeepgramClient()
+
+        # STEP 2 Call the transcribe_url method on the rest class
+        payload: UrlSource = {
+            "url": AUDIO_URL,
+        }
+
+        options: PrerecordedOptions = PrerecordedOptions(
+            model="nova-3",
+            smart_format=True,
+        )
+
+        before = datetime.now()
+        response = deepgram.listen.rest.v("1").transcribe_url(
+            payload, options, timeout=httpx.Timeout(300.0, connect=10.0)
+        )
+        after = datetime.now()
+
+        print(response.to_json(indent=4))
+        print("")
+        difference = after - before
+        print(f"time: {difference.seconds}")
+
+    except Exception as e:
+        print(f"Exception: {e}")
+
+
+if __name__ == "__main__":
+    main()