Magnific API

この記事は翻訳版です。英語版が参照用であり、疑義が生じた場合には英語版が適用されます。

Magnific のストックコンテンツライブラリと AI 搭載ツールを、独自のアプリケーションに統合できます。

Magnific API を使用すると、開発者は Magnific のコンテンツや AI 機能を、独自の製品、プラットフォーム、ワークフローに直接統合できます。Magnific のウェブサイトを手動で操作する代わりに、標準的な REST API 呼び出し を通じて、ストック素材の検索、AI 画像や動画の生成、コンテンツの編集などをプログラムから実行できます。

技術的な詳細（エンドポイント、パラメーター、認証の詳細、コード例、レスポンススキーマ）は、docs.magnific.com の API ドキュメントに記載されています。この記事では、API で何ができるか、どのように使い始めるかといった基本事項を解説します。

APIでできること

APIはいくつかのサービス領域に分類されています。

サービス	機能
ストックコンテンツ	2億点以上の素材（ベクター、写真、アイコン、PSDファイルなど）を検索、フィルター、ダウンロードできます。
AI 画像生成	Mystic、Fluxなど、複数のAIモデルを使用してテキストプロンプトから画像を生成できます。
AI 動画生成	AIモデルを使用して、テキストや画像入力から動画を作成できます。
画像編集	背景除去、Magnificによる画像アップスケーリング、フィルターの適用など、プログラムでさまざまな編集を行えます。
アイコン	フォーマットやスタイルのフィルターを使ってアイコンを検索・ダウンロードできます。
音声	AIで効果音や音声コンテンツを生成

利用可能なサービスやモデルは、Magnificが新しいAI機能を追加するにつれて変更される場合があります。最新のエンドポイントリストについては、docs.magnific.comをご確認ください。

はじめに

API経由でクレジットを消費する方法

ステップ 1 — 設定にアクセスする
ユーザーメニューを開き、組織の「設定」へ進みます。その中にAPI キーセクションがあります。

ステップ 2 — APIキーを作成する
識別用の名前を付けて新しいAPIキーを作成します。システムが自動的に以下を生成します。

APIキー
ウェブフック署名シークレット

どちらも一度しか表示されません。ウィンドウを閉じる前に必ずコピーしてください。

ステップ 3 — キーを管理する

アクションメニューから、シークレットや消費履歴を失うことなく、任意のキーを名前変更できます。
キーを失うことなく、一時的に無効化できます（ローテーションや緊急時に便利です）。
確認を行うことで、キーを完全に削除できます。

ステップ 4 — クレジット使用状況の監査
特定のAPIキーでフィルタリングしてクレジットプールの消費を監査し、使用状況を詳細に管理できます。

Enterpriseアカウント：API Keysセクションがまだ表示されない場合は、担当のMagnificの担当者に連絡してアクセスをリクエストしてください。有効化されると、上記の手順が同様に適用されます。

APIダッシュボード（レガシー）

APIダッシュボードは、API利用に関するすべてを管理するための中心的な拠点です。右上のプロフィール画像をクリックしてAPIダッシュボードを選択するか、magnific.com/developers/dashboardに直接アクセスして利用できます。

ダッシュボードから以下の操作が可能です。

APIキーの表示と再生成
使用状況の追跡とリクエストボリュームのリアルタイム監視
月額予算を設定して、支出を管理しましょう。
レート制限を確認し、各サービスの料金を確認しましょう。
請求先情報と支払い方法を管理しましょう。

クレジットベースモデルのAPI管理パネル

サブスクリプションベースのAPIユーザーは、サブスクリプションパネル内にある管理パネルからアカウントを管理できます。ここでは、以下の操作を行えます。

料金と請求

Magnific APIは、クレジットベースモデルのサブスクリプションシステムを採用しています。

AI生成ツール

API生成リクエスト（画像、動画、音声、アップスケーリング、編集など）ごとに、残高からクレジットが消費されます。

APIを利用するには、以下のサブスクリプションプランから選択できます。

Premium：APIキー1つ、月間20,000クレジットまたは年間240,000クレジット
Premium+：APIキー1つ、月間45,000クレジットまたは年間600,000クレジット
Pro：APIキー3つ、月間300,000クレジットまたは年間4,000,000クレジット
Business：APIキー5つ、月間90,000クレジットまたは年間1,080,000クレジット
Enterprise：無制限のAPIキー、カスタム年間クレジット、利用量に応じたスケーリング

各ツールや生成にかかる詳細なクレジット消費量は、ヘルプセンターで確認できます。

すべてのサブスクリプションで、当社のウェブサイトから直接コンテンツを生成することも可能です。

プランに「無制限」の利用が含まれている場合、これはMagnificのWebアプリ内でのみ適用されます。API呼び出しは常にクレジットを消費しますのでご注意ください。

ストックコンテンツのダウンロード

Premium、Premium+、およびProプラン：API経由のストックダウンロードはクレジットを消費しませんが、1日あたり100回までに制限されています。
BusinessおよびEnterpriseプラン：ストックダウンロードは無制限ですが、他のAPI呼び出しと同様に、クレジット残高から毎回差し引かれます。

レート制限

APIでは、すべての開発者の安定性と公平な利用を確保するためにレート制限を設けています。制限はAPIキーおよびIPアドレスの両方のレベルで適用されます。

制限タイプ	しきい値
1秒あたりのバースト	5秒間のウィンドウで1秒あたり50リクエスト
平均レート	2分間のウィンドウで平均して毎秒10リクエスト
1日の制限	サービスによって異なります。ダッシュボードで、RPD（1日あたりのリクエスト数）およびIPD（1日あたりの画像生成数）の具体的な制限を確認してください。

これらの制限を超えると、制限がリセットされるまでリクエストがスロットリングされるか、一時的にブロックされる場合があります。より高い制限が必要な場合は、営業チームに連絡してカスタムプランについてご相談ください。

利用ルール

Magnific APIは、デジタル製品やワークフローへの統合を目的として設計されています。APIアクセスを有効に保つには、以下のルールに従ってください。

データマイニング、コンテンツスクレイピング、またはAIモデルのトレーニングにAPIを使用しないでください。
Magnificのコンテンツを改変せずに販売または再配布しないでください。
ダウンロードを正確に報告する：ユーザーがリソースを独自に使用するたびに、ダウンロードリクエストをトリガーしてください。例えば、ブログ投稿用に画像を選択したり、ヘッダーとして設定したり、背景として使用したりする場合などが該当します。
キャッシュは許可されています。ただし、有効なプランを維持し、すべてのダウンロードを正確かつ迅速に報告する必要があります。

重要
これらのルールに違反した場合、直ちにAPIへのアクセス権が削除されます。

一般的なエラーコード

リクエストで問題が発生した場合、APIは標準的なHTTPステータスコードを返します。以下に一般的なものを挙げます。

コード	意味	対処法
401 Unauthorized	APIキーが無効であるか、指定されていません。	x-magnific-api-keyヘッダーにキーが含まれていること、および正しくフォーマットされていることを確認してください。
404 Not Found	エンドポイントまたはリソースが存在しません。	URLとリクエストパラメーターを再確認してください。
429 Too Many Requests	レート制限を超過しました。	制限がリセットされるのを待つか、プランをアップグレードするか、より高い制限については営業担当までお問い合わせください。
500 Internal Server Error	サーバー側で問題が発生しました。	リクエストを再試行してください。問題が解決しない場合は、サポートまでお問い合わせください。

レスポンスコードとその意味の全リストについては、APIドキュメントを参照してください。

リソースとサポート

リソース	URL
APIドキュメントの全編	docs.magnific.com
APIランディングページ	magnific.com/api
API ダッシュボード	magnific.com/developers/dashboard
APIプレイグラウンド	magnific.com/api/playground
API 料金	magnific.com/api/pricing
営業担当へのお問い合わせ	magnific.com/api#contact

API連携で問題が発生した場合やご質問がある場合は、magnific.com/api#contactのお問い合わせフォーム、または一般的なサポートページからサポートチームにご連絡ください。