Set a custom thumbnail

PUT/v1/videos/{id}/thumbnail

Replaces the video's thumbnail with a custom image. The request body is the raw image bytes (JPEG, PNG, or WebP; at most 5 MB) and the Content-Type header must match the payload's actual format. Requires an API key with write scope. Rate limit: 30 requests per 60 s per caller.

The custom image survives encode retries; delete it with DELETE /v1/videos/{id}/thumbnail to return to the automatic poster frame.

Error codes: unauthorized (401), insufficient_scope (403), account_not_approved (403), invalid_project_id (400), invalid_image (400), invalid_body (400), not_found (404), video_not_found (404). Unsupported content types return 415; oversize bodies return 413.

المصادقة

apiKey — Project API key: Authorization: Bearer vh_live_... (live mode) or Authorization: Bearer vh_test_... (test mode). Keys carry read and/or write scopes.

المعاملات

الاسم	الموضع	النوع	إلزامي	الوصف
`id`	path	string (Ulid)	نعم	—

جسم الطلب

إلزامي

نوع المحتوى: image/jpeg

نوع المحتوى: image/png

نوع المحتوى: image/webp

الاستجابات

الرمز	المعنى
`200`	The new public thumbnail URL.
`400`	The request body or query failed validation. The per-operation description lists the exact `error.code` values.
`401`	No valid credential was presented.
`403`	The credential is valid but does not permit this action. The per-operation description lists the exact `error.code` values.
`404`	The resource does not exist or is not visible to this caller.
`429`	Rate limit exceeded.

جرّبها

PUT

/v1/videos/{id}/thumbnail

وضع الاختبار فقط

منصة API التفاعلية

أرسل طلبًا حيًا إلى api.videohati.com بمفتاح وضع الاختبار.

تحجب هذه المنصة مفاتيح vh_live_. استخدم مفتاحًا يبدأ بـ vh_test_ فقط؛ لن يغادر أي طلب بمفتاح حي متصفحك.

مفتاح وضع الاختبار

يُحفظ المفتاح في متصفحك على docs.videohati.com فقط.

جسم الطلب (JSON)