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 حوالہ۔