الانتقال إلى المحتوى الرئيسي
POST
/
video
/
retrieve
/api/v1/video/retrieve
curl --request POST \
  --url https://api.venice.ai/api/v1/video/retrieve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "video-model-123",
  "queue_id": "123e4567-e89b-12d3-a456-426614174000",
  "delete_media_on_completion": false
}
'
{
  "status": "PROCESSING",
  "average_execution_time": 145000,
  "execution_duration": 53200
}
بالنسبة للنماذج الخاصة، يتم تنزيل الملف النهائي من download_url الذي تُرجعه /video/queue (وليس بشكل ثنائي من هذه الـ endpoint). راجع روابط التنزيل الخاصة لمعرفة كيفية عمل الرابط وإعادة المحاولة وDELETE الاختيارية.

التفويضات

​
Authorization
string
header
مطلوب

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

الجسم

application/json
​
model
string
مطلوب

The ID of the model used for video generation.

مثال:

"video-model-123"

​
queue_id
string
مطلوب

The ID of the video generation request.

مثال:

"123e4567-e89b-12d3-a456-426614174000"

​
delete_media_on_completion
boolean
افتراضي:false

If true, the video media will be deleted from storage after the request is completed. If false, you can use the complete endpoint to remove the media once you have successfully downloaded the video.

مثال:

false

الاستجابة

Video file if completed, or processing status if still in progress

​
status
enum<string>
مطلوب

The status of the video generation request.

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

"PROCESSING"

​
average_execution_time
number
مطلوب

The estimated execution time of the video generation request in milliseconds (P80).

مثال:

145000

​
execution_duration
number
مطلوب

The current duration of the video generation request in milliseconds.

مثال:

53200