For the complete documentation index, see llms.txt. This page is also available as Markdown.

किसी Source को कनेक्ट करें

USB, RTSP, ONVIF, वेबकैम, फ़ोन, या डायरेक्ट RTMP वीडियो को Cloud Streaming से कनेक्ट करें और प्रत्येक स्रोत की अवधि समझें।

एक स्रोत Cloud Streaming को वीडियो भेजता है। इसे कनेक्ट करने से Workflow शुरू नहीं होता। लाइव वीडियो की पुष्टि करने के बाद, स्रोत पर Workflow चलाएँ।

स्रोत
कनेक्शन
अवधि

USB, RTSP या ONVIF कैमरा

कैमरे के कंप्यूटर या नेटवर्क पर Video Connector

कनेक्टर और कैमरा उपलब्ध रहने तक पुनः उपयोग किया जा सकने वाला स्रोत

कनेक्टर की स्थानीय फ़ाइल

फ़ाइलों की डायरेक्टरी वाला Video Connector

लूप होने वाला लाइव परीक्षण स्रोत, सीमित बैच अपलोड नहीं

ब्राउज़र वेबकैम या फ़ोन QR सत्र

ब्राउज़र कैमरा प्रकाशक

अस्थायी सत्र, केवल प्रीव्यू

RTMP या RTMPS प्रकाशक

ऐप से मिला सीधा प्रकाशन URL

पुनः उपयोग किया जा सकने वाला सीधा स्रोत

वेब ऐप

USB कैमरे

कनेक्टर इंस्टॉल करें और शुरू करें और उसके कंप्यूटर पर कैमरे की पहुँच की अनुमति दें। खोज के बाद समर्थित USB कैमरे "Cloud Streaming" में दिखाई देते हैं। स्रोत का लाइव प्रीव्यू देखें, केवल कैश किए गए थंबनेल की पुष्टि न करें। रिज़ॉल्यूशन, फ़्रेम दर या बिटरेट बदलने के लिए, स्रोत पृष्ठ पर "Capture Settings" का उपयोग करें (देखें कैप्चर और कोडेक सेटिंग).

RTSP और ONVIF कैमरे

"Cloud Streaming" में कनेक्टर खोलें और "RTSP Cameras" ढूँढ़ें (अगर यह मौजूद न हो, तो कनेक्टर अपडेट करें)।

ज्ञात स्ट्रीम जोड़ने के लिए, "Add by RTSP URL" पर क्लिक करें, नाम और कैमरे का पूरा RTSP URL दर्ज करें, उपयोगकर्ता नाम और पासवर्ड उनके अलग-अलग फ़ील्ड में डालें, फिर "Add camera" पर क्लिक करें।

ONVIF खोज के लिए, "Cameras found on the network" से कैमरा चुनें, उसकी लॉगिन जानकारी दर्ज करें और संगत प्रोफ़ाइल चुनें। कनेक्टर को अपने नेटवर्क से कैमरे तक पहुँचने में सक्षम होना चाहिए, और कैमरे की स्ट्रीम का पता मिलने तक कोई स्रोत मौजूद नहीं होता।

प्रोसेसिंग शुरू करने से पहले "Applied" और लाइव स्रोत दिखने तक प्रतीक्षा करें। अगर पैनल में "Rejected by the connector" दिखे, तो कारण पढ़ें, कॉन्फ़िगरेशन ठीक करें और फिर से सेव करें।

कैमरे में बदलाव करने से उसकी स्ट्रीम बाधित हो सकती है। उसे हटाने से स्ट्रीम रुक जाती है, और दोबारा जोड़ने पर नया स्रोत बनता है: Workflow की बाइंडिंग और इतिहास पुराने स्रोत के साथ ही रहते हैं। Roboflow कैमरे की लॉगिन जानकारी संग्रहीत करता है और उसे कनेक्टर तक पहुँचाता है, इसलिए उसे स्क्रीनशॉट और लॉग में न आने दें।

अस्थायी वेबकैम और फ़ोन सत्र

Agent या Workflow एडिटर के स्ट्रीम सेटअप में, "Webcam" या "Phone" चुनें और कैमरे की पहुँच की अनुमति दें। फ़ोन के लिए, QR कोड स्कैन करें। पेयरिंग कोड और QR कोड निजी रखें।

फ़ोन से स्ट्रीमिंग के दौरान, लेंस बदलने के लिए प्रीव्यू के नीचे कैमरा मेन्यू का उपयोग करें (उदा.: Back Ultra Wide Camera, Back Telephoto Camera, Front Camera)। स्ट्रीम चलती रहती है। यह मेन्यू तभी दिखता है जब फ़ोन एक से अधिक कैमरे सूचीबद्ध करता है और उसका ब्राउज़र कैमरा बदलने की सुविधा देता है।

Agent test-source picker with File, Webcam and Stream options.
अस्थायी ब्राउज़र-कैमरा प्रीव्यू शुरू करने के लिए Webcam चुनें।
Connect your phone panel with QR pairing instructions and an expiry timer.
फ़ोन का पेयरिंग कोड स्कैन करें और सत्र के दौरान प्रकाशन पृष्ठ खुला रखें।

प्रकाशक का डिस्कनेक्ट होना या सत्र रोकना, सत्र और उसके जॉब समाप्त कर देता है। अगर नियंत्रण करने वाला ब्राउज़र बंद हो जाए, तो प्रीव्यू भी समाप्त हो जाता है—भले ही फ़ोन अब भी प्रकाशित कर रहा हो। अस्थायी स्रोत केवल प्रीव्यू चलाते हैं और उन्हें स्थायी स्रोत में नहीं बदला जा सकता; लगातार प्रोसेसिंग के लिए कनेक्टर या सीधे स्रोत का उपयोग करें।

सीधा RTMP और RTMPS

सीधा इनजेस्ट "RTMP Stream" के रूप में "Pilot" लेबल के साथ दिखाया जाता है। केवल प्रोटोकॉल के नाम से किसी खास कैमरे, एन्कोडर या फ़र्मवेयर के समर्थन का अनुमान न लगाएँ।

  1. "Add Video Source" खोलें, "RTMP Stream" चुनें, "Source Name" दर्ज करें और "Create stream source" पर क्लिक करें।

  2. कोई प्रोटोकॉल चुनें। अगर आपका प्रकाशक RTMPS का समर्थन करता है, तो उसे प्राथमिकता दें: RTMP वीडियो और स्ट्रीम कुंजी को एन्क्रिप्ट किए बिना भेजता है।

  3. "Server URL" और "Stream Key" को अपने कैमरे या एन्कोडर में कॉपी करें। अगर वह केवल एक पता स्वीकार करता है, तो "Copy full URL" का उपयोग करें और उसकी कुंजी वाला फ़ील्ड खाली छोड़ें।

  4. प्रसारण शुरू करें और लाइव वीडियो आने तक प्रतीक्षा करें, फिर "Run a Workflow" चुनें।

RTMP Stream Pilot setup with RTMPS selected and a masked stream key.
दिए गए प्रकाशन विवरण अपने एन्कोडर में कॉपी करें। स्ट्रीम कुंजी निजी रखें।

होस्टनेम खुद बनाने या URL स्कीम बदलने के बजाय, ऐप से मिले URL का उपयोग करें।

विवरण पाने या कुंजी बदलने के लिए "Connection Settings" फिर से खोलें। "Rotate key" दोनों प्रोटोकॉल के लिए पुरानी कुंजी अमान्य कर देता है, इसलिए प्रकाशक को अपडेट करें और फिर से प्रसारण शुरू करें। ऐप में प्रोटोकॉल बदलने से कुंजी नहीं बदलती और न ही पहले से चल रहा प्रकाशक बदलता है।

डिस्कनेक्ट या कुंजी बदलने के बाद, आने वाले वीडियो और Workflow की स्थिति—दोनों जाँचें: प्रकाशक का कनेक्ट होना इस बात का प्रमाण नहीं कि फ़्रेम आ रहे हैं, और लाइव स्रोत इस बात का प्रमाण नहीं कि Workflow फिर से शुरू हो गया है। देखें पुनः आरंभ का व्यवहार.

कैप्चर और कोडेक सेटिंग

Roboflow में "Capture Settings" का उपयोग करके समर्थित USB कैमरा सेटिंग समायोजित करें, बशर्ते कनेक्टर ऐप-प्रबंधित सेटिंग का समर्थन करता हो। कैमरे द्वारा बताई गई कोई मोड चुनें। पुराना कनेक्टर मौजूदा सेटिंग दिखा सकता है, लेकिन उनमें बदलाव की अनुमति नहीं देता; उन्हें बदलने के लिए कनेक्टर अपडेट करें। कॉन्फ़िगर किया गया FPS कैप्चर सेटिंग है, प्रोसेसिंग थ्रूपुट की गारंटी नहीं।

सेव किया गया बदलाव वांछित कॉन्फ़िगरेशन है, इस बात का प्रमाण नहीं कि वह लागू हो चुका है: लागू स्थिति आने तक प्रतीक्षा करें। कनेक्टर ऑफ़लाइन होने पर बदलाव लंबित रहता है; अस्वीकार की गई सेटिंग की स्थिति में आख़िरी लागू सेटिंग बनी रहती है। बदलाव लागू करने से उस कैमरे की स्ट्रीम फिर शुरू हो सकती है और वीडियो बाधित हो सकता है।

RTSP कैमरे आम तौर पर बिना दोबारा एन्कोड किए कैमरे की अपनी एन्कोड की हुई स्ट्रीम इस्तेमाल करते हैं। कनेक्टर की USB सेटिंग RTSP कैमरे का रिज़ॉल्यूशन, FPS या बैंडविड्थ कम नहीं करतीं। इसके बजाय कैमरे की प्रोफ़ाइल या एन्कोडर सेटिंग बदलें।

ब्राउज़र में व्यापक प्लेबैक संगतता के लिए, B फ़्रेम के बिना H.264 का उपयोग करें; जहाँ संभव हो, बेसलाइन प्रोफ़ाइल चुनें। H.265 या B फ़्रेम वाला H.264 रिले तक पहुँच सकता है, लेकिन ब्राउज़र में चलने में विफल हो सकता है। केवल ट्रांसपोर्ट बदलने से असंगत कोडेक की समस्या ठीक नहीं होती; संगत कैमरा प्रोफ़ाइल या सक्षम होस्ट पर सोच-समझकर ट्रांसकोडिंग का उपयोग करें।

कनेक्टर CLI

स्थानीय फ़ाइल को लूप में चलाएँ

स्थानीय डायरेक्टरी से वीडियो रजिस्टर करने के लिए:

कनेक्टर इन फ़ाइलों को लूप में चलने वाले लाइव स्रोतों के रूप में दोबारा चलाता है। लाइव प्रोसेसिंग के दौरान गति बनाए रखने के लिए कुछ फ़्रेम छोड़े जा सकते हैं। किसी सीमित जॉब में संग्रहीत फ़ाइल को पूरा प्रोसेस करने के लिए, फ़ाइल अपलोड करें या बैच प्रोसेसिंगका उपयोग करें। कनेक्टर पर फ़ाइल का मौजूद होना उसे क्लाउड बैच अपलोड नहीं बनाता।

थंबनेल नियंत्रित करें

कनेक्टर स्रोत सूची के लिए छोटे स्थिर चित्र ले सकता है, जिनमें स्रोत का पता चलने के तुरंत बाद और बाद के रिफ़्रेश के दौरान लिए गए चित्र शामिल हैं। इससे कैमरे की इंडिकेटर लाइट थोड़ी देर के लिए जल सकती है, भले ही कोई Workflow चल न रहा हो। RTSP थंबनेल कैप्चर के लिए कैमरे का एक अलग, छोटा सत्र खुल सकता है।

आगे से कैप्चर रोकने के लिए कनेक्टर के पेज पर “कैमरा थंबनेल” बंद करें, या स्थानीय ओवरराइड के रूप में --no-thumbnails के साथ लॉन्च करें। कैप्चर बंद करने से मौजूदा थंबनेल मिटता नहीं है। थंबनेल लाइव वीडियो या रिकॉर्डिंग नहीं है, न ही यह इस बात का प्रमाण है कि प्रोसेसिंग चल रही है।

HTTP API

उपयोग करें API प्रमाणीकरण पाथ में दिए गए वर्कस्पेस के क्रेडेंशियल के साथ। RTSP कैमरे जोड़ने, कनेक्टर कॉन्फ़िगर करने, सीधे RTMP स्रोत बनाने और पब्लिशिंग कीज़ बदलने के लिए Roboflow ऐप का उपयोग करें। API में इनके लिए कोई एंडपॉइंट नहीं हैं।

रजिस्टर किए गए स्रोतों की सूची बनाएँ

स्रोतों की सूची बनाएँ, इच्छित स्रोत ID चुनें और जॉब बनाने से पहले उसकी उपलब्धता जाँचें। अस्थायी स्रोत केवल ज़रूरत पड़ने पर शामिल करें। स्रोत रिकॉर्ड में उसके कैमरे के पब्लिशिंग क्रेडेंशियल शामिल नहीं होते।

List Cloud Streaming sources

get

Lists registered sources without stream credentials. Temporary sessions are excluded unless requested. The response contains sources only, not jobs or a webcam-availability flag. Requires video-inference-job:read. Use a workspace API key or OAuth access token for the workspace in the path. Device-bound keys are not accepted.

Authorizations
AuthorizationstringRequired

Roboflow API key or OAuth access token.

Path parameters
workspacestringRequired

Workspace URL slug.

Query parameters
includeTemporarybooleanOptional

Include workspace temporary sessions.

Default: false
Responses
200

Successful response.

application/json
get/{workspace}/video-sources/v1
GET /{workspace}/video-sources/v1 HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "sources": [
    {
      "id": "SOURCE_ID",
      "workspace": "WORKSPACE_ID",
      "kind": "usb",
      "name": "Warehouse camera",
      "status": "connected",
      "availableProcessorSizes": [
        "gpu-s-v1",
        "gpu-m-v1",
        "gpu-l-v1"
      ],
      "persistentWorkflowsAvailable": true
    }
  ]
}

स्रोत वीडियो का पूर्वावलोकन करें

Workflow असाइन करने से पहले इनपुट प्लेबैक का अनुरोध करें। स्रोत का पूर्वावलोकन वीडियो की मांग पैदा करता है; यह मॉडल इन्फ़रेंस नहीं करता। लौटाए गए किसी भी प्लेबैक URL को क्रेडेंशियल मानें, उसका उपयोग केवल इच्छित दर्शक के लिए करें और उसे लॉग, स्थायी स्टोरेज या स्क्रीनशॉट में न रखें।

Preview raw source video

post

Requests source demand and placement, not Workflow inference. For connector sources, renew the five-minute demand lease while viewing. Direct-source grants include expiresAt; reacquire before it expires. Returns raw-source playback credentials or an uploaded-file playback URL. These grants are sensitive and can include a long-lived connector source credential. Requires video-inference-job:create. Use a workspace API key or OAuth access token for the workspace in the path. Device-bound and folder-scoped credentials are not accepted.

Authorizations
AuthorizationstringRequired

Roboflow API key or OAuth access token.

Path parameters
workspacestringRequired

Workspace URL slug.

sourceIdstring · min: 1 · max: 256Required

Cloud Streaming source ID from the source list.

Pattern: ^[^/\\]+$
Body
cellstring · nullableOptional

Optional source placement cell. Omit for server selection.

Responses
200

Successful response.

application/json
or
post/{workspace}/video-sources/v1/{sourceId}/preview
POST /{workspace}/video-sources/v1/{sourceId}/preview HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2

{}
{
  "kind": "live",
  "cell": "CELL_ID",
  "placementGeneration": 1,
  "whepUrl": "https://relay.example.invalid/src-SOURCE_ID/whep?key=READ_GRANT"
}

अस्थायी सत्र आवंटित करें

ब्राउज़र से पब्लिश करने के हर प्रयास के लिए अलग सत्र आवंटित करें और उसी प्रयास को दोबारा आज़माते समय एक स्थिर idempotency key का उपयोग करें। अनुमति की अवधि समाप्त होने से पहले वीडियो पब्लिश करने के लिए लौटाए गए WHIP URL का ज्यों का त्यों उपयोग करें। केवल सत्र आवंटित करने से कैमरे के फ़्रेम पब्लिश नहीं होते।

Allocate a temporary source

post

Allocates one WHIP publishing session. The publishing grant admits one publisher within two minutes. At most four unexpired publishing grants may be outstanding per workspace. Repeating the same request and Idempotency-Key returns the same live session, not a renewed grant. A stopped session cannot be revived by replay. Its jobs end when the publisher is lost or the session is stopped. This is source allocation, not a browser capture, recording or reconnect API. Requires video-inference-job:create. Use a workspace API key or OAuth access token for the workspace in the path. Device-bound and folder-scoped credentials are not accepted.

Authorizations
AuthorizationstringRequired

Roboflow API key or OAuth access token.

Path parameters
workspacestringRequired

Workspace URL slug.

Header parameters
Idempotency-Keystring · min: 8 · max: 128Required

A unique key for one start attempt. Reuse the same key, request and credential after a lost response. Use a new key only for a new attempt.

Example: run-warehouse-camera-001Pattern: ^[A-Za-z0-9._:-]+$
Body
namestring · min: 1 · max: 100Optional

Session display name.

Default: Browser preview
cellstringOptional

Optional enabled temporary-source cell allowed for this workspace. Omit for server placement.

Pattern: ^[a-z0-9-]{1,63}$
Responses
200

Successful response.

application/json
sourceIdstringRequired

Allocated temporary source ID.

Pattern: ^tmp-[a-f0-9]{40}$
grantExpiresAtinteger · int64Required

Deadline to admit the publisher. Unix time in milliseconds.

whipUrlstring · uriRequired

Credentialed single-publisher WHIP URL. Use unchanged and never log, persist or share it.

post/{workspace}/video-sources/v1/temporary
POST /{workspace}/video-sources/v1/temporary HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Idempotency-Key: text
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "name": "Browser preview"
}
{
  "source": {
    "id": "tmp-0000000000000000000000000000000000000000",
    "kind": "temporary",
    "name": "Browser preview",
    "status": "awaiting_video",
    "persistentWorkflowsAvailable": false
  },
  "sourceId": "tmp-0000000000000000000000000000000000000000",
  "grantExpiresAt": 1800000120000,
  "whipUrl": "https://relay.example.invalid/src-SESSION_ID/whip?key=PUBLISH_GRANT"
}

अस्थायी सत्र वाले जॉब केवल पूर्वावलोकन के लिए हैं। पब्लिशिंग सत्र और उसके जॉब के स्वामी की अवधि अलग-अलग होती है; देखें अस्थायी पूर्वावलोकन का स्वामित्व.

अस्थायी सत्र रोकें

कैप्चर पूरा होने पर सत्र रोकें। इससे पब्लिशिंग एक्सेस रद्द हो जाता है और उससे जुड़े जॉब रद्द हो जाते हैं। केवल Workflow जॉब रोकना, उसके स्रोत सत्र को समाप्त करने से अलग है।

End a temporary source session

post

Invalidates the session's publisher credential, requests publisher disconnection and cancels its jobs. Use this only for a temporary source. Requires video-inference-job:create. Use a workspace API key or OAuth access token for the workspace in the path. Device-bound and folder-scoped credentials are not accepted.

Authorizations
AuthorizationstringRequired

Roboflow API key or OAuth access token.

Path parameters
workspacestringRequired

Workspace URL slug.

sourceIdstringRequired

Cloud Streaming source ID from the source list.

Pattern: ^tmp-[a-f0-9]{40}$
Responses
200

Successful response.

application/json
stopRequestedconst: Required
post/{workspace}/video-sources/v1/{sourceId}/stop-session
POST /{workspace}/video-sources/v1/{sourceId}/stop-session HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "source": {
    "id": "SOURCE_ID",
    "workspace": "WORKSPACE_ID",
    "kind": "usb",
    "name": "Warehouse camera",
    "status": "connected",
    "availableProcessorSizes": [
      "gpu-s-v1",
      "gpu-m-v1",
      "gpu-l-v1"
    ],
    "persistentWorkflowsAvailable": true
  },
  "stopRequested": true
}

अंतिम अपडेट

क्या यह उपयोगी था?