Magick API で最初のテキスト、画像、動画リクエストを完了する

Magick API 公式開発ドキュメント

Magick API へようこそ。このページは整理されたソースドキュメントに基づき、最短の導入手順を示し、最初の呼び出しを完了できるようにします。

ヒント：Magick API のドメインと API KEY に置き換えるだけで、コードの修正なしにワンクリックで移行できます！

ドメイン："https://api.magickapi.com" 、OpenAI スタイルのインターフェースに完全互換
API KEY: 管理画面で生成

ステップ1：API Key の取得

API Key 管理ページを開きます。
アカウントにログインし、新しい API Key を作成します。
キーを安全に保管し、以降の呼び出しでは Authorization: Bearer YOUR_API_KEY で渡します。

ステップ2：インターフェースタイプの選択

テキストと多くの画像インターフェースは通常、同期的に結果を返します。動画インターフェースは非同期タスクモードを採用しており、送信が成功すると id / task_id が返されます。

汎用モデル

テキスト生成、マルチターン対話、マルチモーダル入力、ツール呼び出しに適しています。

画像生成モデル

テキストからの画像生成、画像からの画像生成、部分的な再描画、複数参照画像生成に適しています。

動画モデル

テキストからの動画生成、先頭フレーム/先頭・末尾フレーム動画生成、動画の続き書きに適しています。

ステップ3：リクエストの送信

テキスト生成の例

curl -X POST https://api.magickapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5",
    "messages": [
      {
        "role": "user",
        "content": "コーディングに最適な大規模モデルを調査して推薦してください"
      }
    ]
  }'

画像生成の例

curl -X POST https://api.magickapi.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "ロールスロイスの後部座席で泣いているかわいい猫",
    "size": "1:1",
    "n": 1
  }'

動画生成の例

curl -X POST https://api.magickapi.com/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-fast-generate-preview",
    "prompt": "小さな女の子が窓辺に座り、春風に揺れる柳の木を眺めている",
    "duration": 8,
    "size": "1280x720"
  }'

ステップ4：タスクステータスの確認

動画インターフェースが id / task_id を返した後、OpenAI 互換の動画タスク endpoint で結果をポーリングできます。

curl -X GET https://api.magickapi.com/v1/videos/YOUR_TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

タスク完了後、動画コンテンツをダウンロードできます。

curl -L https://api.magickapi.com/v1/videos/YOUR_TASK_ID/content \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --output output.mp4

送信後、5～10秒待ってからポーリングを開始し、その後は3～5秒ごとに照会することをお勧めします。

次のステップ

テキスト対話インターフェース：汎用対話インターフェース（デフォルトストリーミング）から始めます。
OpenAI Responses：OpenAI Responses マルチモーダルインターフェースをお読みください。
画像生成：GPT-Image-2 画像生成をお読みください。
動画生成：VEO3 動画生成をお読みください。

クイックスタート