Embed a GIF in a Video

This endpoint enriches the content of a video by allowing users to embed additional GIF’s within the video frame. Users can specify the position and size of the GIF, enhancing the video's storytelling or providing supplementary visual content.

Pricing: 5 credits per minute of video input.

GEThttps://api.spikes.studio/add-gif

Required Parameters

Name
video_url
Type
string
Description
The URL of the video for which the GIF will be added.
- Supported Formats: MP4, MOV, AVI, WMV
- Example: "https://example.com/video.mp4"
Name
gif_url
Type
file
Description
- Supported Formats: JPEG, PNG, etc.
- Size Limit: Up to 5MB
- Example: "https://example.com/animation.gif"

Optional Parameters

Name
position
Type
string
Description
The position on the video frame where the GIF will be placed.
- Default: "TL" (Top Left)
- Options: "TL" (Top Left), "TM" (Top Middle), "TR" (Top Right), "ML" (Middle Left), "MC" (Middle Center), "MR" (Middle Right), "BL" (Bottom Left), "BM" (Bottom Middle), "BR" (Bottom Right).
Name
size
Type
string
Description
The size category for the gif to be displayed in the video.
- Default: "M" (Meduim)
- Options: "S" (Small), "M" (Medium), "L" (Large)

Response

Name
project
Type
json
Description
A Project Object. Use the id to query it's status using the Get project endpoint

Request

POST

https://api.spikes.studio/gif

  {
      "video_url" : "https://my.website.com/clip.mp4",
      "gif_url" : "https://my.website.com/animation.gif",
      "position" : "TL",
      "size" : "M"
  }

Response

  {
    "id": "b012b6cd-d8c4-4b55-b3ec-b023f7e2d935",
    "platform_url": "https://my.website.com/clip.mp4",
    "download_url" : null,
    "thumbnail_url": null
  }

Errors

Name
400 Bad Request
Description
The request was malformed or missing required parameters.
Name
401 Unauthorized
Description
The API key provided was invalid or missing.
Name
404 Not Found
Description
The requested resource was not found.
Name
500 Internal Server Error
Description
500 Internal Server Error