Guide utilisateur Magick API

Décrit l'état d'intégration de `gpt-image-2-official` dans le projet actuel, ainsi que les champs de requête et la structure de réponse de l'interface d'image unifiée.

Le chemin de la page est conservé pour décrire l'état d'intégration dans le projet actuel
Interface d'image unifiée : POST /v1/images/generations
La réponse réussie est synchrone ImageResponse

État d'intégration actuel

Ce modèle a été retiré, veuillez utiliser le meilleur modèle gpt-image-2 pour obtenir les meilleurs résultats

Conception de l'interface d'image publique

Routage de la requête

POST /v1/images/generations

Structure de la réponse réussie

{
  "created": 1712345678,
  "data": [
    {
      "url": "https://example.com/generated-image.png",
      "b64_json": "",
      "revised_prompt": ""
    }
  ]
}

Champs de requête standard

Le projet actuel garantit que les champs standard suivants sont disponibles :

model
prompt
n
size
quality
response_format

Exemples d'appel directement copiables

Les exemples suivants s'appliquent lorsque "le backend a déjà mappé gpt-image-2-official comme modèle disponible" :

cURL

curl --request POST \
  --url https://api.magickapi.com/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2-official",
    "prompt": "星空下的古老城堡",
    "n": 1,
    "size": "1024x1024",
    "quality": "high",
    "response_format": "url"
  }'

Python

import requests

url = "https://api.magickapi.com/v1/images/generations"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "model": "gpt-image-2-official",
    "prompt": "星空下的古老城堡",
    "n": 1,
    "size": "1024x1024",
    "quality": "high",
    "response_format": "url",
}

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

result = response.json()
print(result)
print("image_url:", result["data"][0]["url"])

Node.js

const url = "https://api.magickapi.com/v1/images/generations";
const payload = {
  model: "gpt-image-2-official",
  prompt: "星空下的古老城堡",
  n: 1,
  size: "1024x1024",
  quality: "high",
  response_format: "url",
};

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(result);
console.log("image_url:", result.data?.[0]?.url);

Si vous souhaitez obtenir directement le contenu Base64, changez response_format en b64_json, puis lisez data[0].b64_json.

Édition d'image

Si le canal correspondant à ce modèle prend en charge la capacité d'édition, les points d'entrée d'édition unifiés sont :

POST /v1/images/edits
POST /v1/edits

GPT Image 2 Official