Create session
Creates a new LemonSlice session that takes in avatar audio and returns synchronized video/audio to LiveKit or Pipecat (Daily).
Authorizations
Your LemonSlice API token.
Body
The properties used to create a self-managed session. Use application/json to reference an agent_id or agent_image_url, or multipart/form-data to upload an image file directly.
- By agent_image_url
- By agent_id
Input to create an agent session. Exactly one of agent_id or agent_image_url must be provided.
A URL to an agent image to use. The image should be 368x560 pixels. LemonSlice will automatically center-crop your image to the target aspect ratio if the dimensions do not match the expected values. Provide either agent_image_url or agent_id, but not both.
"https://example.com/custom_agent.png"
The interface type for how the audio is sent and how the A/V is returned.
livekit, daily A high-level system prompt that subtly influences the avatar's movements, expressions, and emotional demeanor. This prompt is best used to suggest general affect or demeanor (for example, 'feel excited' or 'look sad') rather than precise or deterministic actions.
A high-level system prompt that influences the avatar's movements, expressions, and emotional demeanor during the idle state.
Idle timeout in seconds. If a negative number is provided, the session will have no idle timeout.
Time in seconds to wait without receiving new audio bytes before marking the response as complete. Some TTS models do not send an end response event, or do not send it in a timely manner. This parameter enables detection of response completion when such events are missing or delayed. This parameter can also be used to ensure proper conversation flow with multi-message LLMs (e.g. gpt-realtime-2).
Output aspect ratio for the avatar video.
2x3, 9x16, 1x1 Model variant. Leave null to use the normal flagship model.
lite, flash, pro, null Enable WebRTC simulcast, which publishes multiple resolutions of the avatar video so subscribers receive the best quality their bandwidth allows. LiveKit transport only.
Additional properties needed to connect to the transport layer.
- LiveKit
- Daily
Response
Session created successfully.
The ID of the session.
"3f7c2b91-9e1f-4a6a-8e9d-2c7c3e7d9b5a"

