Skip to main content
POST
/api/v1/audio/voice-changer/queue
استدعِ /audio/voice-changer/quote لتقدير التكلفة، ثم استعلِم /audio/voice-changer/retrieve باستخدام الـ queue_id المُعاد حتى ينتهي التحويل. عملية التحويل الموضوعة في قائمة الانتظار تكون قد خُصمت بالفعل. إذا فُقدت هذه الاستجابة، استعلم عن الاسترجاع بدلًا من إعادة وضع الطلب في قائمة الانتظار. إذا كنت تحتفظ بالوسائط المُحوَّلة بعد الاسترجاع، فاستدعِ /audio/voice-changer/complete بعد تنزيلها. نماذج تغيير الصوت غير مقبولة على /audio/queue. راجع دليل تغيير الصوت للحصول على شرح تفصيلي كامل.

مجموعة Postman

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

التفويضات

Authorization
string
header
مطلوب

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

الجسم

model
string
مطلوب

The voice-changer model to run. Models that are not voice changers are not supported here; use the /api/v1/audio endpoints instead.

مثال:

"elevenlabs-voice-changer"

file
file

The source recording (multipart/form-data, field name "file"). Accepted containers are listed per model as accepted_audio_formats in /models. Mutually exclusive with audio_url.

audio_url
string

Publicly reachable http(s) URL of the source recording. Venice fetches and validates the bytes itself and forwards only those bytes to the provider, so the URL is never handed onward. Mutually exclusive with the multipart file field.

مثال:

"https://example.com/source-recording.mp3"

voice
string

The target voice: one of the model’s voices from /models, or a provider Voice ID when the model reports supports_custom_voice_id. Defaults to the model’s default_voice.

مثال:

"Aria"

remove_background_noise
boolean

Strip background noise from the source recording before conversion.

مثال:

false

seed
integer

Seed for reproducible output. Omit for a non-deterministic result.

النطاق المطلوب: x >= 0
مثال:

42

الاستجابة

Voice conversion queued successfully

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"

status
enum<string>
مطلوب

Always QUEUED. The provider has accepted the job.

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

"QUEUED"

duration_seconds
number
مطلوب

Length of the source recording in seconds, measured server-side, and therefore the exact quantity billed for this request. Use it to reconcile against the estimate from /audio/voice-changer/quote.

مثال:

52