Avatar Marketing VideoはTopviewのプロダクトマーケティング動画生成ツールです。ユーザーが商品画像、スクリプト、または素材をアップロードするだけで、ワンクリックで着用やインタラクションのデモ動画を生成できます。多言語に対応しています。
デモ動画productLink と fileIds パラメータを同時に送信した場合、fileIds パラメータは無視され、デフォルトで productLink から解析されたすべての動画と画像が使用されます。
本インターフェースは非同期インターフェースであり、送信が成功するとIDが返されます。ユーザーはMarketing video 結果取得インターフェースを通じて処理結果を確認できます。 Request
Example:Bearer {{YOUR_API_KEY}}
Body Params application/json
動画または画像は、アップロードインターフェースを通じてアップロードした後、fileIdを取得します。
製品リンクから自動解析可能です。productLink が空の場合は必須で す。
製品リンクから自動解析可能です。productLink が空で、かつ isDiyScript=false の場合は必須です。
デフォルト値:9:16。選択可能な値:9:16、3:4、1:1、4:3、16:9
デフォルト値: en
言語リスト:
英語: en
アラビア語 (العربية): ar
ブルガリア語 (Български): bg
クロアチア語 (Hrvatski): hr
チェコ語 (Čeština): cs
デンマーク語 (Dansk): da
オランダ語 (Nederlands): nl
フィリピン語 (Filipino): fil
フィンランド語 (Suomi): fi
フランス語 (Français): fr
ドイツ語 (Deutsch): de
ギリシャ語 (Ελληνικά): el
ヒンディー語 (हिन्दी): hi
ハンガリー語 (Magyar): hu
インドネシア語 (Bahasa Indonesia): id
イタリア語 (Italiano): it
日本語 (日本語): ja
韓国語 (한국어): ko
マレー語 (Bahasa Melayu): ms
ノルウェー語 (Norsk): nb
ポーランド語 (Polski): pl
ポルトガル語 (Português): pt
ルーマニア語 (Română): ro
ロシア語 (Русский): ru
簡体字中国語 (简体中文): zh-CN
スロバキア語 (Slovenčina): sk
スペイン語 (Español): es
スウェーデン語 (Svenska): sv
繁体字中国語 (繁體中文): zh-Hant
トルコ語 (Türkçe): tr
ウクライナ語 (Українська): uk
ベトナム語 (Tiếng Việt): vi
タイ語 (ภาษาไทย): th. 現在、タイ語でサポートされている voiceIds は次の通りです: 5d188a658b5a424e98bf0dbbcb8f97d8, eea5e5a4fb534231a5b4cf4766dd7a5f, 537e2643719c47bdac1d8a2c7f0c844a, e22db502aa8d40d9ba791083c9f4ab35
デフォルト値:1。1:30~50秒;2:15~30秒;3:30~45秒;4:45~60秒
デフォルト値:all。選択可能な値:all、9:16、3:4、1:1、4:3、16:9
endcardBackgroundColor
string
optionalデフォルト値:black。オプション値:black、white
カスタムスクリプトを使用するかどうか。True - カスタムスクリプトを使用します。デフォルトは false です。
diyScriptDescription
string
optionalカスタムスクリプトの内容は、isDiyScript=trueの場合にのみ有効です。
{
"fileIds": [
"8d745437254941adb141f95836d9454c"
],
"productName": "8d745437254941adb141f95836d9454c.mp4",
"productDescription": "303 talk"
}
Request samples
curl --location --request POST 'https://api.302.ai/topview/v1/m2v/task/submit' \
--header 'Content-Type: application/json' \
--data-raw '{
"fileIds": [
"8d745437254941adb141f95836d9454c"
],
"productName": "8d745437254941adb141f95836d9454c.mp4",
"productDescription": "303 talk"
}'
Responses
application/json {"code":"200","message":"Success","result":{"taskId":"f58e38c01cdc497d9c6d05fbf54fef4e","status":"success","errorMsg":null,"subTaskId":"f58e38c01cdc497d9c6d05fbf54fef4e"}}
Modified at 2025-07-15 08:48:05