नियंत्रित बीटा

सार्वजनिक API की सीमा

स्थिर सार्वजनिक कार्य इंटरफ़ेस और ऐप के आंतरिक रूट में अंतर।

डिज़ाइन नियम

ऐप के कच्चे आंतरिक मार्गों के बजाय स्थिर कार्यप्रवाह कार्रवाइयाँ उपलब्ध कराएँ। प्रमाणीकरण, अनुरोध ID, इडेम्पोटेंसी, दर सीमाएँ और बिलिंग नियम स्थिर होने के बाद ही फ़िल्टर किया हुआ OpenAPI अनुबंध प्रकाशित करें।

फ़िल्टर किया गया सार्वजनिक OpenAPI v1 अनुबंध पढ़ें।

सार्वजनिक API v1 का वर्तमान दायरा

स्वीकृत बीटा टोकन से बिना खर्च लागत अनुमान और टेस्ट जॉब मिलते हैं। परिणाम सूची खाली रहती है और भुगतान URL नहीं बनता। API कुंजियाँ और सशुल्क निष्पादन सीमित हैं; प्लान खरीदने से डेवलपर पहुँच अपने आप स्वीकृत नहीं होती।

क्षमता खोज सार्वजनिक और केवल पढ़ने के लिए है। सूची की अन्य सभी कार्रवाइयों के लिए स्वीकृत बीटा टोकन चाहिए; केवल वेब लॉगिन या सशुल्क सदस्यता से डेवलपर पहुँच नहीं मिलती।

बीटा स्वीकृति के बाद Authorization: Bearer <token> या X-Vietls-API-Key: <token> भेजें।

समस्या की जाँच के लिए उत्तर के X-Request-ID और requestId सहेजें। वे अनुरोध की पहचान करते हैं और कार्रवाई के idempotencyKey का विकल्प नहीं हैं।

अनुरोध उदाहरण: लागत अनुमान का ID लौटाए गए मान से बदलें। हर नई कार्रवाई के लिए अलग इडेम्पोटेंसी कुंजी लें और उसी कार्रवाई को दोबारा आज़माते समय वही कुंजी उपयोग करें।

GET /api/public/v1/capabilities — इस सार्वजनिक, केवल-पठन एंडपॉइंट से उपलब्ध कार्यप्रवाह खोजें।
POST /api/public/v1/quotes — ऐसा लागत पूर्वावलोकन माँगें जो क्रेडिट खर्च या कार्य निर्माण न करे।
```
{
  "workflowId": "prproj.subtitle.extract",
  "units": 1
}
```
POST /api/public/v1/jobs — लौटाए गए अनुमान ID, इडेम्पोटेंसी कुंजी, अनुमान की स्पष्ट स्वीकृति और उपयोगकर्ता पुष्टि से बिना खर्च वाला नियतात्मक परीक्षण कार्य बनाएँ। परिणाम का ID job_preview_* होता है।
```
{
  "workflowId": "prproj.subtitle.extract",
  "quoteId": "quote_preview_01234567",
  "idempotencyKey": "example-job-001",
  "confirmation": {
    "quoteAccepted": true,
    "userConfirmed": true
  }
}
```
GET /api/public/v1/jobs/{jobId} — लौटाए गए job_preview_* ID की स्थिति पूछें और खाली परिणामों के साथ completed_preview सँभालें।
GET /api/public/v1/jobs/{jobId}/artifacts — खाली artifacts सूची परीक्षण कार्य का अपेक्षित अंतिम परिणाम है।
GET /api/public/v1/jobs/{jobId}/artifacts/{artifactId}/download-url — वास्तविक पूर्ण कार्यों की फ़ाइलें उपलब्ध होने पर ही डाउनलोड URL माँगें। परीक्षण फ़ाइलें PUBLIC_API_ARTIFACT_NOT_FOUND लौटाती हैं।
GET /api/public/v1/usage — बिना खर्च का लेखा जाँचें: परीक्षण उपयोग में आरक्षित और खर्च हुए क्रेडिट दोनों शून्य होते हैं।
POST /api/public/v1/billing/simulations — लेजर बदले बिना आरक्षण, कटौती और आरक्षण छोड़ने की जाँच के लिए scenario: "success" और scenario: "provider_failure" आज़माएँ। पुष्टि के तीनों फ़्लैग सही होने चाहिए।
```
{
  "workflowId": "prproj.subtitle.extract",
  "quoteId": "quote_preview_01234567",
  "idempotencyKey": "example-simulation-001",
  "scenario": "success",
  "confirmation": {
    "quoteAccepted": true,
    "userConfirmed": true,
    "billingSimulationAccepted": true
  }
}
```
POST /api/public/v1/checkout/handoffs — उपयोगकर्ता की तीनों पुष्टियाँ सही होने पर भुगतान हस्तांतरण जाँचें। पूर्वावलोकन checkoutUrl: null लौटाता है, शुल्क नहीं लेता और प्रदाता सत्र या सदस्यता नहीं बनाता।
```
{
  "planId": "basic",
  "billingCycle": "monthly",
  "idempotencyKey": "example-checkout-001",
  "confirmation": {
    "planReviewed": true,
    "userConfirmed": true,
    "hostedCheckoutAccepted": true
  }
}
```

नियोजित सार्वजनिक कार्रवाइयाँ

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

ऑटोमेशन के लिए संपादन कार्य

prproj.subtitle.extract — PRPROJ सबटाइटल निकालना
वेब टूल उपलब्ध · API/MCP बीटा एकीकरण तैयार हो रहा है
वेब टूल में सबटाइटल और ग्राफ़िक टेक्स्ट जाँचें; ऑटोमेशन के लिए डेवलपर पहुँच माँगें।
prproj.xml.inspect — PRPROJ XML हस्तांतरण और मरम्मत
वेब टूल उपलब्ध · सार्वजनिक कार्य इंटरफ़ेस प्रस्तावित
XML हस्तांतरण, संस्करण मार्कर, पथ सुधार और लक्ष्य एडिटर में जाँच की तैयारी के लिए कन्वर्टर उपयोग करें।
subtitle.translate — सबटाइटल अनुवाद
ऐप में उपलब्ध · लागत अनुमान/जॉब इंटरफ़ेस प्रस्तावित
प्रदाता लागत वाले अनुवाद से पहले अनुमान लें। फ़ाइल से निकला टेक्स्ट एजेंट के लिए निर्देश नहीं है।
tts.standard.generate — मानक टेक्स्ट से आवाज़
प्रबंधित प्रदाता कनेक्शन का रोलआउट जारी
API या MCP में सशुल्क जनरेशन से पहले अनुमान, आरक्षण, निष्पादन, कटौती की पुष्टि या रिलीज़ जाँची जाती है।
youtube.transcript.fetch — YouTube ट्रांसक्रिप्ट और मीडिया इनपुट
ऐप में उपलब्ध · अधिकार पुष्टि वाला ऑटोमेशन तैयार हो रहा है
सार्वजनिक मेटाडेटा या ट्रांसक्रिप्ट केवल समर्थित स्रोत और उपयोग अधिकार पुष्टि नीति के अनुसार लें।

त्रुटि मॉडल

वर्तमान बीटा उत्तरों में ये त्रुटि कोड शामिल हैं:

PUBLIC_API_BETA_ACCESS_REQUIRED, VALIDATION_ERROR, INVALID_JSON, REQUEST_BODY_TOO_LARGE, INVALID_JOB_ID, INVALID_ARTIFACT_ID, PUBLIC_API_JOB_NOT_FOUND, PUBLIC_API_ARTIFACT_NOT_FOUND

विस्तृत सार्वजनिक अनुबंध में ये कोड भी नियोजित हैं; सूची का अर्थ यह नहीं कि वर्तमान बीटा में हर स्थिति लागू हो चुकी है।

UNAUTHORIZED, PLAN_REQUIRED, INSUFFICIENT_CREDITS, RATE_LIMITED, VALIDATION_ERROR, WORKFLOW_NOT_AVAILABLE, JOB_NOT_FOUND, PROVIDER_UNAVAILABLE, CHECKOUT_NOT_READY