معاينة واجهة Cloud العامة
واجهة Cloud للمطورين غير الصادرة، مع Artifacts للإدخال وJobs دائمة للإخراج.
لم تُصدر واجهة Cloud API
هذه معاينة للعقد وليست وجهة لحركة الإنتاج. لا يحتوي مستند OpenAPI على خادم، وتستخدم الأمثلة العنصر النائب $VOICESTUDIO_CLOUD_ORIGIN.
| المصدر | القيمة |
|---|---|
| المنتج | واجهة VoiceStudio Cloud العامة للمطورين |
| الفئة المستهدفة | بيانات اعتماد المطور العامة فقط |
| إصدار العقد | 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. تأتي صلاحية الوصول دائمًا من بيانات الاعتماد وعضوية المستأجر؛ ولا يمنحها معرّف في الطلب مطلقًا.
المخططات الدقيقة: مرجع Cloud API.