These docs are for v2.0. Click to read the latest docs for v3.0.

Add Video to your NFTs

This page explains how you can add videos to your NFTs.

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).

📘

Prerequisites

  1. You already have an NFT collection (contract) created using the NFT-API. View the Getting Started guide if you haven't.
  2. 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:

NFT with a video

NFT with a video