Skip to content

Commit 839f4aa

Browse files
committed
split into compose/auto, describe Auto, make consistent capitalization.
1 parent 5a6bb17 commit 839f4aa

11 files changed

+32
-26
lines changed

api-reference/WSDC_Migration_Guide.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ It's simple, the datachannel worked horribly as a session init mechanism over tu
2323

2424
### Session Init
2525

26-
Well, you had a POST call to `https://api.simli.ai/StartWebRTCSession` which you sent a JSON with `{sdp: pc.localDescription.sdp, type: pc.localDescription.type}`. Now, it's a WebSocket connection to `wss://api.simli.ai/StartWebRTCSession` to which you send the same JSON. On it, you receive two messages, the first one is reserved for possible future behavior, the second one is the output of the POST call: `{sdp:remoteSDP, type:"answer"}`. The second response you use with `pc.setRemoteDescrition(ANSWER_RECEIVED_FROM_WEBSOCKET)` and that's the main difference in session initiallization nothing more.
26+
Well, you had a POST call to `https://api.simli.ai/startWebRTCSession` which you sent a JSON with `{sdp: pc.localDescription.sdp, type: pc.localDescription.type}`. Now, it's a WebSocket connection to `wss://api.simli.ai/startWebRTCSession` to which you send the same JSON. On it, you receive two messages, the first one is reserved for possible future behavior, the second one is the output of the POST call: `{sdp:remoteSDP, type:"answer"}`. The second response you use with `pc.setRemoteDescrition(ANSWER_RECEIVED_FROM_WEBSOCKET)` and that's the main difference in session initiallization nothing more.
2727

2828
### Sending and Receiving Data
2929

Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: '/StartWebRTCSession'
2+
title: '/startWebRTCSession'
33
description: 'Start a WebRTC session'
4-
openapi: 'POST /StartWebRTCSession'
4+
openapi: 'POST /startWebRTCSession'
55
---

api-reference/endpoint/customLLM.mdx

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
2-
title: "Use your own LLM"
2+
title: "Bring your own LLM"
33
icon: comments
44
---
55

66
TL;DR, If you have an OpenAI compatible API (test it out with the python or JS SDKs), pass [Simli the base url, an API key, and the model name](/api-reference/endpoint/startE2ESession#body-custom-llm-config-base-url) and you're golden!
77

88
## Background
99

10-
Using the Simli manged API is awesome! But it can be a bit difficult to tailor it out for your needs. You may have a custom knowledgebase, a RAG powered system, using your finetuned LLM that's the best doctor or tutor ever known to mankind that you self-host, or just want to use a model that we don't readily support. If that's you, hello, you're in the right place.
10+
Using Simli Auto (our end-to-end API) is awesome! But it can be a bit difficult to tailor it out for your needs. You may have a custom knowledge base, a RAG powered system, using your fine-tuned LLM that's the best doctor or tutor ever known to mankind that you self-host, or just want to use a model that we don't readily support. If that's you, you're in the right place.
1111

1212
There's a fun trick that you may already know about if you're this deep into the weeds, if you look at the [Deepseek api docs](https://api-docs.deepseek.com/), you can see that they're using the OpenAI SDK as if it was their own! They just put in the base_url for their API and the API key and then it works as if nothing weird is going on.
1313

api-reference/endpoint/startE2ESession.mdx

+4
Original file line numberDiff line numberDiff line change
@@ -3,4 +3,8 @@ title: "/startE2ESession"
33
openapi: "POST /startE2ESession"
44
---
55

6+
The Simli Auto API offers a quick and easy way to make an end-to-end real-time interaction. Simli Auto now supports [custom LLMs](api-reference/endpoint/customLLM), but if you need even more composability, check out the [Simli Compose API Reference](/api-reference/endpoint/textToVideoStream) instead.
7+
8+
This endpoint allows you to start a new end-to-end session.
9+
610
for changing the interaction languages, you can look at the support list on [Deepgram's website](https://developers.deepgram.com/docs/models-languages-overview)

api-reference/openapi.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -174,7 +174,7 @@
174174
}
175175
},
176176

177-
"/StartWebRTCSession": {
177+
"/startWebRTCSession": {
178178
"post": {
179179
"summary": "Start WebRTC Session",
180180
"requestBody": {

api-reference/simli-agent.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Create Simli Agent
33
icon: github
44
---
55

6-
The easiest way to get started building with Simli is by using the Create Simli Agent repo. This allows you to get an agent interaction running in minutes, perfect for a proof-of-concept or simple web-app.
6+
The easiest way to get started building with Simli is by using the Create Simli Agent repo together with Simli Auto. This allows you to get an agent interaction running in minutes, perfect for a proof-of-concept or simple web-app.
77

88
Important: This solution has limited composability, so if you are planning on building custom features or need to control your own LLM, you should use PipeCat instead.
99

api-reference/simli-webrtc.mdx

+2-2
Original file line numberDiff line numberDiff line change
@@ -188,7 +188,7 @@ async function connectToRemotePeer() {
188188
var codec;
189189
document.getElementById("offer-sdp").textContent = offer.sdp;
190190

191-
const ws = new WebSocket("wss://api.simli.ai/StartWebRTCSession");
191+
const ws = new WebSocket("wss://api.simli.ai/startWebRTCSession");
192192
wsConnection = ws;
193193
ws.addEventListener("open", () => {
194194
ws.send(
@@ -536,7 +536,7 @@ function connectToRemotePeer() {
536536
var codec;
537537
document.getElementById("offer-sdp").textContent = offer.sdp;
538538

539-
const ws = new WebSocket("wss://api.simli.ai/StartWebRTCSession");
539+
const ws = new WebSocket("wss://api.simli.ai/startWebRTCSession");
540540
wsConnection = ws;
541541
ws.addEventListener("open", () => {
542542
ws.send(

api-reference/webrtc-signaling-guide.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ title: 'WebRTC with WebSockets Signaling Guide'
44

55
This endpoint is a websocket endpoint that takes in a stream of PCM16 audio frames and a set of control signals to manage a WebRTC Stream. The server sends only pongs, keepalive "ACK" messages, and a STOP signal when the server wants to terminate the session
66

7-
<Note>WebSocket URL: `wss://api.simli.ai/StartWebRTCSession`</Note>
7+
<Note>WebSocket URL: `wss://api.simli.ai/startWebRTCSession`</Note>
88

99
## Initial Request Format
1010

get-started.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ description: "Use our simli-client sdk to start streaming"
1919
Our API comprimises of two main components:
2020

2121
- `/startAudioToVideoSession` API to initialize a session.
22-
- `/StartWebRTCSession` WebRTC API to start streaming `PCM16` audio bytes to video.
22+
- `/startWebRTCSession` WebRTC API to start streaming `PCM16` audio bytes to video.
2323

2424
If you're a WebRTC enthusiast, we encourage you to learn more about [Simli WebRTC](/api-reference/simli-webrtc)
2525

introduction.mdx

+3-3
Original file line numberDiff line numberDiff line change
@@ -14,22 +14,22 @@ Clone a starter repo to get started in minutes
1414
icon="github"
1515
href="https://github.com/simliai/create-simli-agent"
1616
>
17-
The quickest way to get started building with Simli is by using the Create Simli Agent repo. This allows you to get a basic agent interaction running in minutes, perfect for a proof-of-concept or simple web-app.
17+
The quickest way to get started building with Simli is by using the Create Simli Agent repo together with Simli Auto. This allows you to get a basic agent interaction running in minutes, perfect for a proof-of-concept or simple web-app.
1818
</Card>
1919
<Card
2020
title="Pipecat"
2121
icon="github"
2222
href="https://github.com/pipecat-ai/pipecat"
2323
>
24-
We recommend using Pipecat's starter repo if you want more composability and customization, for example if you need to bring your own LLM.
24+
We recommend using Pipecat if you want more composability and customization, for example if you need to bring your own LLM.
2525
</Card>
2626

2727
<Card
2828
title="create-simli-app"
2929
icon="github"
3030
href="https://github.com/simliai/create-simli-app-openai"
3131
>
32-
This repo is a simple Next.JS app that uses Simli with OpenAI real-time conversations, but you can swap it out with any other voice provider you'd like!
32+
This repo is a simple Next.JS app that uses Simli Compose with OpenAI real-time conversations, but you can swap it out with any other voice provider you'd like!
3333
</Card>
3434

3535
## An API with endless possibilities.

mint.json

+14-12
Original file line numberDiff line numberDiff line change
@@ -53,20 +53,20 @@
5353
]
5454
},
5555
{
56-
"group": "Video API Reference",
56+
"group": "Simli Compose - API Reference",
5757
"pages": [
5858
"api-reference/endpoint/textToVideoStream",
5959
"api-reference/endpoint/audioToVideoStream",
6060
"api-reference/endpoint/startAudioToVideoSession",
61-
"api-reference/endpoint/StartWebRTCSession",
62-
"api-reference/endpoint/getIceServers",
63-
{
64-
"group": "End 2 End API (Simli Auto)",
65-
"pages": [
66-
"api-reference/endpoint/startE2ESession",
67-
"api-reference/endpoint/customLLM"
68-
]
69-
}
61+
"api-reference/endpoint/startWebRTCSession",
62+
"api-reference/endpoint/getIceServers"
63+
]
64+
},
65+
{
66+
"group": "Simli Auto - API Reference",
67+
"pages": [
68+
"api-reference/endpoint/startE2ESession",
69+
"api-reference/endpoint/customLLM"
7070
]
7171
},
7272
{
@@ -78,11 +78,13 @@
7878
},
7979
{
8080
"group": "",
81-
"pages": ["api-reference/discord"]
81+
"pages": [
82+
"api-reference/discord"
83+
]
8284
}
8385
],
8486
"modeToggle": {
8587
"default": "dark",
8688
"isHidden": true
8789
}
88-
}
90+
}

0 commit comments

Comments
 (0)