Magick API ユーザーガイド

`gemini-3.1-flash-image-preview` の本プロジェクトにおける接続方法について説明します。このモデルは Gemini ネイティブモデルに属し、統一画像インターフェースを経由しません。

本プロジェクトでは POST /v1/images/generations 経由でこのモデルを公開しません
このモデルはプロジェクト内で Gemini ネイティブモデルの接続面に属します
呼び出しルートは POST /v1beta/models/{model}:{action} を使用してください

推奨ルート

POST /v1beta/models/gemini-3.1-flash-image-preview:{action}

よく使われるアクション:

generateContent
streamGenerateContent

そのままコピーして使える呼び出し例

cURL

curl --request POST \
  --url https://api.magickapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "生成一张赛博朋克风格的城市夜景。"
          }
        ]
      }
    ]
  }'

Python

import json
import requests

url = "https://api.magickapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "生成一张赛博朋克风格的城市夜景。"
                }
            ],
        }
    ]
}

response = requests.post(url, headers=headers, json=payload, timeout=300)
response.raise_for_status()

result = response.json()
print(json.dumps(result, ensure_ascii=False, indent=2))

Node.js

const url =
  "https://api.magickapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent";
const payload = {
  contents: [
    {
      role: "user",
      parts: [
        {
          text: "生成一张赛博朋克风格的城市夜景。",
        },
      ],
    },
  ],
};

const response = await fetch(url, {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify(payload),
});

if (!response.ok) {
  throw new Error(await response.text());
}

const result = await response.json();
console.log(JSON.stringify(result, null, 2));

レスポンスについて

このモデルは Gemini ネイティブの JSON 構造を返し、統一画像インターフェースのような形式には変換されません:

{
  "data": [
    {
      "url": "..."
    }
  ]
}

具体的な出力構造は Gemini ネイティブプロトコルに従って解析し、「汎用モデル / Gemini ネイティブ形式」ページを参照してください。

Gemini 3.1 Flash Image