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 রেফারেন্স।