Add Videos to NFTs

In this guide, we will look into how you can add a video or multiple videos to your NFTs, Note that adding the videos will happen during the creation of the token-type (NFT tenplate).

📘

You need to have the URL of the video address that you wish to add.

Learn how to store your media/images on Venly Servers.

Prerequisites

You already have an NFT collection (contract) created using the NFT-API. View the Getting Started guide if you haven't.
contractAddress: The public address of your NFT contract.

Request Endpoint: reference

POST /api/v2/token-types/creations

Example Request

We will use the create token-type endpoint and within the request body, we will specify the animationUrls array.

POST /api/v2/token-types/creations

Request Body

📘

In the animationUrls array, we have defined the object with type: video and its value(The URL of the video address).

You can add multiple objects within the animationUrls array with images, videos, and even audio.

Read more about [animationUrls](https://docs.venly.io/docs/animation-media)

{
  "secretType": "MATIC",
  "contractAddress": "0xf5b11b4f458cc12a7989a146c5db2e7d500e2241",
  "creations": [{
    "name": "NFT with a video",
    "description": "This NFT has a video",
    "image": "https://static.scientificamerican.com/sciam/cache/file/C91AC5AA-1F28-41E7-8E40EC59E66937D8_source.jpg?w=590&h=800&2113BA5E-A58F-4A28-ABDD0BE5C759F5B6",
    "externalUrl": "www.venly.io",
    "animationUrls": [{
      "type": "video",
      "value": "https://player.vimeo.com/external/314181352.sd.mp4?s=d2cd7a37f6250cd543e6d13209730b4bcf242130&profile_id=164&oauth2_token_id=57447761"
    }]
  }]
}

Response Body

📘
The token-type was created successfully with a video included. You can check its status using the result.creations.id param.

{
  "success": true,
  "result": {
    "creations": [
      {
        "id": "20bd87e9-c590-47fb-a3e3-679673556e6b",
        "status": "PENDING",
        "tokenTypeId": 9,
        "metadata": {
          "name": "NFT with a video",
          "description": "This NFT has a video",
          "image": "https://static.scientificamerican.com/sciam/cache/file/C91AC5AA-1F28-41E7-8E40EC59E66937D8_source.jpg?w=590&h=800&2113BA5E-A58F-4A28-ABDD0BE5C759F5B6",
          "imagePreview": "https://static.scientificamerican.com/sciam/cache/file/C91AC5AA-1F28-41E7-8E40EC59E66937D8_source.jpg?w=590&h=800&2113BA5E-A58F-4A28-ABDD0BE5C759F5B6",
          "imageThumbnail": "https://static.scientificamerican.com/sciam/cache/file/C91AC5AA-1F28-41E7-8E40EC59E66937D8_source.jpg?w=590&h=800&2113BA5E-A58F-4A28-ABDD0BE5C759F5B6",
          "animationUrl": "https://player.vimeo.com/external/314181352.sd.mp4?s=d2cd7a37f6250cd543e6d13209730b4bcf242130&profile_id=164&oauth2_token_id=57447761",
          "animation_url": "https://player.vimeo.com/external/314181352.sd.mp4?s=d2cd7a37f6250cd543e6d13209730b4bcf242130&profile_id=164&oauth2_token_id=57447761",
          "externalUrl": "www.venly.io",
          "external_url": "www.venly.io",
          "animationUrls": [
            {
              "type": "video",
              "value": "https://player.vimeo.com/external/314181352.sd.mp4?s=d2cd7a37f6250cd543e6d13209730b4bcf242130&profile_id=164&oauth2_token_id=57447761"
            }
          ],
          "attributes": [
            {
              "type": "system",
              "name": "tokenTypeId",
              "value": "9",
              "traitType": "Token Type ID",
              "trait_type": "Token Type ID"
            }
          ],
          "contract": {
            "address": "0xf5b11b4f458cc12a7989a146c5db2e7d500e2241",
            "name": "Test",
            "symbol": "TE",
            "image": "string",
            "imageUrl": "string",
            "image_url": "string",
            "description": "Testing",
            "externalLink": "www.venly.io",
            "external_link": "www.venly.io",
            "externalUrl": "www.venly.io",
            "external_url": "www.venly.io",
            "media": [],
            "type": "ERC_1155"
          },
          "fungible": false
        }
      }
    ]
  }
}

NFT Minted Preview

Here is how the minted NFT will look like with a video added: