Guide utilisateur Magick API

Décrit l'état d'intégration de Seedream 4.5 dans le projet actuel, ainsi que la conception commune de l'interface d'image unifiée.

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

Conception de l'interface d'image du projet actuel

Routage des requêtes

POST /v1/images/generations

Structure de la réponse en cas de succès

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

Champs de requête standard

L'interface d'image publique du projet actuel garantit que les champs suivants sont correctement analysés :

model
prompt
n
size
quality
response_format

Modèles d'appel prêts à être copiés

Si le backend ajoute ultérieurement un mapping de canal pour Seedream 4.5, l'interface externe doit toujours respecter l'interface d'image unifiée du projet actuel.

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": "seedream-4.5",
    "prompt": "Un panda mignon jouant dans une forêt de bambous",
    "n": 1,
    "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": "seedream-4.5",
    "prompt": "Un panda mignon jouant dans une forêt de bambous",
    "n": 1,
    "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: "seedream-4.5",
  prompt: "Un panda mignon jouant dans une forêt de bambous",
  n: 1,
  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);

Seedream 4.5

Sommaire