簡介

A.V. Mapping 影音服務 API 可以讓使用者上傳影像並且進行影像分析服務，進而獲取符合影像情境的配樂、音效，甚至可以進行影片音軌降躁的功能。

如果您有任何問題，歡迎來信至 [email protected]

快速啟動

獲取 API Token

1. 確認資訊與身分：登入至網站 avmapping.co，確認您影像創作者身分資訊已填寫完畢
2. 訂閱會員：確認為影像創作者訂閱會員身分，帳號開通時即同時開通免費會員身分
3. 申請 API Token：請來信至 [email protected] 或填寫表單

傳送你的第一個 API call

以下有三個參數可以被包含在 request header 中來更動 API 回傳的資料，而其中 authorization (API token) 為必須提供的項目

1. authorization 為必須要提供的 header 資料，可以給予使用者存取 API 的權限
2. accept-language 回傳資料的語言，目前僅提供 zh 與 en，若無提供則預設為 zh
3. avma-currency 回傳資料的價格幣別，目前僅提供 TWD、USD 與 EUR 三種幣別，若無提供則預設為 TWD

在獲取需要的 token 與確定需要獲取的資料類型後，即可透過 POST 或 GET 來存取影像服務相關的 API 。

範例：獲取回傳資料為 英文 與 美金$ 的影像庫清單

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

快速啟動影像服務

影像服務的核心流程包含上傳影片、啟動影像分析服務，以及獲取分析結果。您需要依序執行以下三個步驟：