Skip to main content
POST
/api/v1/audio/voice-changer/retrieve
استخدم الـ queue_id المُعاد من /audio/voice-changer/queue للتحقق من حالة التحويل. أثناء تنفيذ المهمة، تُعيد هذه الـ endpoint JSON يحتوي على status: "PROCESSING". عند اكتمالها تُعيد audio/mpeg. عيّن delete_media_on_completion على true لتنظيف الوسائط المُخزَّنة في الاستدعاء نفسه، أو استدعِ /audio/voice-changer/complete بعد تنزيل الملف. نماذج تغيير الصوت غير مقبولة على /audio/retrieve.

مجموعة Postman

للمزيد من الأمثلة، يرجى مراجعة مجموعة Postman هذه.

التفويضات

Authorization
string
header
مطلوب

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

الجسم

application/json
model
string
مطلوب

The model that is running the conversion. Only voice-changer models are accepted on the /api/v1/audio/voice-changer endpoints.

مثال:

"elevenlabs-voice-changer"

queue_id
string
مطلوب

Pass this to /audio/voice-changer/retrieve to poll for the converted audio, and to /audio/voice-changer/complete when finished.

مثال:

"0190f2c4-9c1e-7a3b-8f42-2c9d5e7a1b34"

delete_media_on_completion
boolean
افتراضي:false

Release the provider-held media as soon as this call returns the audio, so a separate /audio/voice-changer/complete call is unnecessary. The audio cannot be retrieved again afterwards.

مثال:

false

الاستجابة

Conversion still processing, or the completed audio

status
enum<string>
مطلوب

The conversion is still running. Poll again.

الخيارات المتاحة:
PROCESSING
مثال:

"PROCESSING"

average_execution_time
number
مطلوب

Recent average end-to-end time for this model in milliseconds. Use it to pace polling.

مثال:

10000

execution_duration
number
مطلوب

Milliseconds elapsed since the conversion was queued.

مثال:

4200