MeduxMedux

Video > Add Logo to Video

Add Logo to Video

Overlay a logo image onto a video.

POST/api/app/v1/process/video/add_logo_to_video

Examples

curl -X POST https://api.medux.io/api/app/v1/process/video/add_logo_to_video \
  -H 'Authorization: Bearer $MEDUX_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"logo_file_id":"FILE_ID","model_id":"add-logo-to-video-default","video_file_id":"FILE_ID","x":10,"y":10}'

Media Samples

Approved examples for understanding request inputs, response shape, and official example output.

Official add logo to video sample

This example uses add-logo-to-video-default.

Sample request

Example input for this capability.

video_file_id{file_id}logo_file_id{file_id}x10y10

Sample response

Official example output for preview only. It is not a user Media Result.

Example output

Auth Requirements

Authentication is required via Authorization header.

Preconditions

Upload the source file and create a file reference before calling this endpoint.

Successful requests return a Medux task record immediately. Use the task query or sync endpoints to track completion.

All file inputs must be uploaded and persisted as file references before submission.

Request

Body

application/json
Authorizationstringrequired

Bearer token or API key.

Location: HEADER

video_file_idstringrequired

Input video file_id.

Location: BODY

logo_file_idstringrequired

Logo image file_id.

Location: BODY

xintegeroptional

Logo X position, default 10. Default: 10.

Location: BODY

yintegeroptional

Logo Y position, default 10. Default: 10.

Location: BODY

logo_widthintegeroptional

Logo width in pixels. If set, logo_height must also be set.

Location: BODY

logo_heightintegeroptional

Logo height in pixels.

Location: BODY

model_idstringoptional

Model Default: add-logo-to-video-default.

Location: BODY

titlestringoptional

Optional task title.

Location: BODY

Response

Response

application/json
codeint32optional

response code enums:
.. 0: ok
.. 12: invalid input
.. 1410: invalid model
.. 1409: paid plan required
.. 1401: insufficient credits
.... 1401 ~ 1499 是 media
.. 1404: provider error
.. 1405: provider timeout
.. 13: unauthenticated
.. 16: rate limit
.. 99: server error

Available options: 0 12 1410 1409 1401 1404 1405 13 16 99

Location: RESPONSE

data.assetobjectoptional

No description provided.

Location: RESPONSE

data.paid_plan_requiredobjectoptional

No description provided.

Location: RESPONSE

data.taskobjectoptional

No description provided.

Location: RESPONSE

messagestringoptional

No description provided.

Available options: ok invalid input invalid model paid plan required insufficient credits provider error provider timeout unauthenticated rate limit server error

Location: RESPONSE

MCP Tool

This endpoint is also available through the Medux-hosted remote MCP service.

Add Logo to Video

Overlay a logo image onto a video.

Invocation Example

Overlay a logo image onto a video.