1# Stream Live Streaming API
2 
3Live input creation, status checking, simulcast, and WebRTC streaming.
4 
5## Create Live Input
6 
7### Using Cloudflare SDK
8 
9```typescript
10import Cloudflare from 'cloudflare';
11 
12const client = new Cloudflare({ apiToken: env.CF_API_TOKEN });
13 
14const liveInput = await client.stream.liveInputs.create({
15  account_id: env.CF_ACCOUNT_ID,
16  recording: { mode: 'automatic', timeoutSeconds: 30 },
17  deleteRecordingAfterDays: 30
18});
19 
20// Returns: { uid, rtmps, srt, webRTC }
21```
22 
23### Raw fetch API
24 
25```typescript
26async function createLiveInput(accountId: string, apiToken: string) {
27  const response = await fetch(
28    `https://api.cloudflare.com/client/v4/accounts/${accountId}/stream/live_inputs`,
29    {
30      method: 'POST',
31      headers: { 'Authorization': `Bearer ${apiToken}`, 'Content-Type': 'application/json' },
32      body: JSON.stringify({
33        recording: { mode: 'automatic', timeoutSeconds: 30 },
34        deleteRecordingAfterDays: 30
35      })
36    }
37  );
38  const { result } = await response.json();
39  return {
40    uid: result.uid,
41    rtmps: { url: result.rtmps.url, streamKey: result.rtmps.streamKey },
42    srt: { url: result.srt.url, streamId: result.srt.streamId, passphrase: result.srt.passphrase },
43    webRTC: result.webRTC
44  };
45}
46```
47 
48## Check Live Status
49 
50```typescript
51async function getLiveStatus(accountId: string, liveInputId: string, apiToken: string) {
52  const response = await fetch(
53    `https://api.cloudflare.com/client/v4/accounts/${accountId}/stream/live_inputs/${liveInputId}`,
54    { headers: { 'Authorization': `Bearer ${apiToken}` } }
55  );
56  const { result } = await response.json();
57  return {
58    isLive: result.status?.current?.state === 'connected',
59    recording: result.recording,
60    status: result.status
61  };
62}
63```
64 
65## Simulcast (Live Outputs)
66 
67### Create Output
68 
69```typescript
70async function createLiveOutput(
71  accountId: string, liveInputId: string, apiToken: string,
72  outputUrl: string, streamKey: string
73) {
74  return fetch(
75    `https://api.cloudflare.com/client/v4/accounts/${accountId}/stream/live_inputs/${liveInputId}/outputs`,
76    {
77      method: 'POST',
78      headers: { 'Authorization': `Bearer ${apiToken}`, 'Content-Type': 'application/json' },
79      body: JSON.stringify({
80        url: `${outputUrl}/${streamKey}`,
81        enabled: true,
82        streamKey // For platforms like YouTube, Twitch
83      })
84    }
85  ).then(r => r.json());
86}
87```
88 
89### Example: Simulcast to YouTube + Twitch
90 
91```typescript
92const liveInput = await createLiveInput(accountId, apiToken);
93 
94// Add YouTube output
95await createLiveOutput(
96  accountId, liveInput.uid, apiToken,
97  'rtmp://a.rtmp.youtube.com/live2',
98  'your-youtube-stream-key'
99);
100 
101// Add Twitch output
102await createLiveOutput(
103  accountId, liveInput.uid, apiToken,
104  'rtmp://live.twitch.tv/app',
105  'your-twitch-stream-key'
106);
107```
108 
109## WebRTC Streaming (WHIP/WHEP)
110 
111### Browser to Stream (WHIP)
112 
113```typescript
114async function startWebRTCBroadcast(liveInputId: string) {
115  const pc = new RTCPeerConnection();
116  
117  // Add local media tracks
118  const stream = await navigator.mediaDevices.getUserMedia({ video: true, audio: true });
119  stream.getTracks().forEach(track => pc.addTrack(track, stream));
120  
121  // Create offer
122  const offer = await pc.createOffer();
123  await pc.setLocalDescription(offer);
124  
125  // Send to Stream via WHIP
126  const response = await fetch(
127    `https://customer-<CODE>.cloudflarestream.com/${liveInputId}/webRTC/publish`,
128    {
129      method: 'POST',
130      headers: { 'Content-Type': 'application/sdp' },
131      body: offer.sdp
132    }
133  );
134  
135  const answer = await response.text();
136  await pc.setRemoteDescription({ type: 'answer', sdp: answer });
137}
138```
139 
140### Stream to Browser (WHEP)
141 
142```typescript
143async function playWebRTCStream(videoId: string) {
144  const pc = new RTCPeerConnection();
145  
146  pc.addTransceiver('video', { direction: 'recvonly' });
147  pc.addTransceiver('audio', { direction: 'recvonly' });
148  
149  const offer = await pc.createOffer();
150  await pc.setLocalDescription(offer);
151  
152  const response = await fetch(
153    `https://customer-<CODE>.cloudflarestream.com/${videoId}/webRTC/play`,
154    {
155      method: 'POST',
156      headers: { 'Content-Type': 'application/sdp' },
157      body: offer.sdp
158    }
159  );
160  
161  const answer = await response.text();
162  await pc.setRemoteDescription({ type: 'answer', sdp: answer });
163  
164  return pc;
165}
166```
167 
168## Recording Settings
169 
170| Mode | Behavior |
171|------|----------|
172| `automatic` | Record all live streams |
173| `off` | No recording |
174| `timeoutSeconds` | Stop recording after N seconds of inactivity |
175 
176```typescript
177const recordingConfig = {
178  mode: 'automatic',
179  timeoutSeconds: 30, // Auto-stop 30s after stream ends
180  requireSignedURLs: true, // Require token for VOD playback
181  allowedOrigins: ['https://yourdomain.com']
182};
183```
184 
185## In This Reference
186 
187- [README.md](./README.md) - Overview and quick start
188- [api.md](./api.md) - On-demand video APIs
189- [configuration.md](./configuration.md) - Setup and config
190- [patterns.md](./patterns.md) - Full-stack flows, best practices
191- [gotchas.md](./gotchas.md) - Error codes, troubleshooting
192 
193## See Also
194 
195- [workers](../workers/) - Deploy live APIs in Workers
196