素材ライブラリのよくある質問

よくある質問

コンソールで作成したグループが API で表示されない

コンソールで作成したグループは GET /api/v1/materials/groups に表示されます。手元にグループ ID しかない場合でも、POST /api/v1/materials/assets でそのまま group_id として使用できます。プラットフォームはまずグループの存在を確認し、それを現在のアカウントにバインドするため、以降はグループ一覧に表示されます。

審査失敗の理由はどこで確認できますか

素材照会で返される data.asset.error_message が失敗理由です。status が Failed の場合にのみ内容があり、正常時および利用可能な状態では null です。

画像審査にはどれくらいかかりますか

審査と前処理は非同期で、時間は素材自体によって異なります。プラットフォームはすべての画像に対して一律の時間を約束するものではありません。プログラムは同じ素材 ID をポーリングし、初期ステータスが Processing だからといって重複して送信しないでください。

頻繁な照会は制限されますか

ステータス照会は軽量なエンドポイントですが、1 つのポーリング周期内で重複して並行リクエストを送らないでください。同じ素材 ID を 5～10 秒に 1 回照会することをおすすめします。リクエストが頻繁すぎる場合、エンドポイントは HTTP 429 を返します。しばらくしてから再試行すれば問題なく、送信済みの素材には影響しません。

画像アドレスにはどのような要件がありますか

プラットフォームのサーバー側が直接ダウンロードできる http(s) アドレス（http と https の両方に対応）である必要があり、Cookie、Referer、ログインページ、IP ホワイトリストに依存できません。画像がログインが必要なアドレスの背後にある場合、社内ネットワーク内にある場合、ローカルファイルしかない場合は、先にオブジェクトストレージに転送するか data_url を使用してください。そうしないと素材の処理に失敗します。

公開アドレスを用意できる場合は image_url を優先してください。プラットフォームはアドレスをそのまま転送し、ダウンロードや転送を行わないため、審査の送信が最も速くなります。data_url は画像全体の base64 をアップロードする必要があり、明らかに遅く、プラットフォームのストレージも消費します。