Guide utilisateur Magick API

Décrit comment `gemini-3.1-flash-image-preview` est intégré dans le projet actuel : il s'agit d'un modèle natif Gemini, qui ne passe pas par l'interface d'image unifiée.

Le projet actuel n'expose pas ce modèle via POST /v1/images/generations
Ce modèle fait partie de l'interface d'accès native Gemini dans le projet
La route d'appel doit utiliser POST /v1beta/models/{model}:{action}

Route recommandée

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

Actions courantes :

generateContent
streamGenerateContent

Exemples d'appel prêts à l'emploi

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));

Description de la réponse

Ce modèle renvoie une structure JSON native Gemini, qui n'est pas convertie en interface d'image unifiée :

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

Pour la structure de sortie spécifique, veuillez l'analyser selon le protocole natif Gemini et vous référer à la page « Modèles généraux / Format natif Gemini ».

Gemini 3.1 Flash Image