Cloud सार्वजनिक API प्रीव्यू
अभी जारी न हुई Cloud डेवलपर API, जिसमें इनपुट Artifacts और टिकाऊ आउटपुट Jobs हैं।
Cloud API जारी नहीं हुई है
यह कॉन्ट्रैक्ट का प्रीव्यू है, प्रोडक्शन ट्रैफ़िक भेजने की जगह नहीं। OpenAPI दस्तावेज़ में सर्वर नहीं है और उदाहरण $VOICESTUDIO_CLOUD_ORIGIN प्लेसहोल्डर उपयोग करते हैं।
| स्रोत विवरण | मान |
|---|---|
| उत्पाद | VoiceStudio Cloud सार्वजनिक डेवलपर API |
| उपयोगकर्ता वर्ग | केवल सार्वजनिक डेवलपर क्रेडेंशियल |
| कॉन्ट्रैक्ट संस्करण | 1.0.0 |
| जनरेट किए गए कॉन्ट्रैक्ट का संस्करण | 1.0.0 |
| सोर्स रिपॉज़िटरी | debpalash/vssaas |
| सोर्स कमिट | c48c41f8fe5bb4496a9d218c513fd91fe827c0b5 |
| कच्चा सार्वजनिक प्रोजेक्शन | /cloud-openapi.json |
इसमें 34 डेवलपर ऑपरेशन हैं। डैशबोर्ड, ऑपरेटर और आंतरिक ऑपरेशन तथा केवल उनके उपयोग वाले स्कीमा बाहर रखे गए हैं।
काम कैसे चलता है
Cloud का काम सीधी कॉल नहीं है। इनपुट अपरिवर्तनीय Artifacts बनते हैं, फिर प्रमाणित अनुरोध एक टिकाऊ Job स्वीकार कर तुरंत लौटता है। हर बदलाव में कॉल करने वाले की बनाई Idempotency-Key लगती है: समान कुंजी और बॉडी से समान नतीजा मिलता है, बदली हुई बॉडी पर संघर्ष होता है।
यह न चलने वाला प्रीव्यू है। इसमें प्रोडक्शन होस्ट नहीं है:
export VOICESTUDIO_CLOUD_ORIGIN="https://unreleased.invalid"
export VOICESTUDIO_API_KEY="vs_preview_only"
# 1. Ask to upload the exact text bytes.
curl "$VOICESTUDIO_CLOUD_ORIGIN/v1/artifacts/upload-authorizations" \
-H "Authorization: Bearer $VOICESTUDIO_API_KEY" \
-H "Idempotency-Key: 018f-example-upload-key" \
-H "Content-Type: application/json" \
-d '{
"project_id": "replace-with-project-id",
"purpose": "tts_text",
"media_type": "text/plain; charset=utf-8",
"size_bytes": 24,
"sha256": "replace-with-64-lowercase-hex-characters"
}'
# 2. PUT the bytes to the returned short-lived URL, then complete the Artifact.
curl "$VOICESTUDIO_CLOUD_ORIGIN/v1/artifacts/ARTIFACT_ID/complete" \
-H "Authorization: Bearer $VOICESTUDIO_API_KEY" \
-H "Idempotency-Key: 018f-example-complete-key" \
-H "Content-Type: application/json" \
-d '{ "size_bytes": 24, "sha256": "replace-with-64-lowercase-hex-characters" }'
# 3. Admit a Job. Success is 202 Accepted, not audio.
curl "$VOICESTUDIO_CLOUD_ORIGIN/v1/jobs" \
-H "Authorization: Bearer $VOICESTUDIO_API_KEY" \
-H "Idempotency-Key: 018f-example-job-key" \
-H "Content-Type: application/json" \
-d '{
"project_id": "replace-with-project-id",
"workflow": "tts",
"model": { "id": "replace-with-model-id", "version": "replace-with-version" },
"input": { "text_artifact_id": "replace-with-artifact-id" },
"configuration": { "voice_id": "replace-with-voice-id", "output_format": "wav" }
}'202 Accepted बॉडी में Job की पहचान और स्थिति होती है। GET /v1/jobs/{job_id} पोल करें या GET /v1/jobs/{job_id}/events फिर शुरू करें, फिर Artifact डाउनलोड प्राधिकरण से आउटपुट लें। पहुँच हमेशा क्रेडेंशियल और टेनेंट सदस्यता से मिलती है; अनुरोध में ID कभी पहुँच नहीं देती।
सटीक स्कीमा: Cloud API संदर्भ।