Introduction

A.V. Mapping Music to Video Service API allows users to upload images and video, perform image/video analysis services to obtain music and sound effects that fit the image/video context. Along with audio noise reduction API.

Quick Start

Obtaining an API Token

  1. Check your ID and Info: After login to avmapping.co, check user info as filmmakers. Fill up the blocks.
  2. Subscribe: Check out the membership. Or start with a FREE trial when you activate the account.
  3. Apply the token: Fill up the form. Or Email to: [email protected]

Sending your first API call

There are three parameters that can be included in the request header to modify the data returned by the API, and authorization (API token) is a required item.

  1. authorization is a required header data that can give users access to the API.
  2. accept-language specifies the language of the returned data. Currently, only zh and en are available. If not provided, the default is zh.
  3. avma-currency specifies the price currency of the returned data. Currently, only TWD, USD, and EUR are available. If not provided, the default is TWD.

After obtaining the required token and determining the type of data to be obtained, you can use POST or GET to access the film Service API.

For example, to obtain a list of image libraries with data returned as USD$ in English:

curl <https://filmmusic.avmapping.co/film/> \\
-H "authorization: Token 3c2924a718c4a100f04ae442a7308c7cd5c7a681" \\
-H "accept-language: en" \\
-H "avma-currency: usd"

Quick Start of Film Service

The core process of the film service includes uploading a video, initiating the image analysis service, and retrieving the analysis results. You need to perform the following three steps in order:

  1. Upload a visual file to create a ‘Film object’

    You first need to upload a video file or image file via POST /film/ or provide a YouTube URL to create a Film object. Upon successful upload, the API will return the created id.

    Request Example

    curl <https://filmmusic.avmapping.co/film/> \\
-X POST \\
-H "authorization: Token 3c2924a718c4a100f04ae442a7308c7cd5c7a681" \\
-H "Content-Type: application/x-www-form-urlencoded" \\
-F file=@filename

    Response

    {
    "id": 1320
}