Image Generation
v0.4.0Générez des images par IA à partir d'une description textuelle. Images PNG haute qualité en quelques secondes.
Base URL :
https://api.s33d.fr
POST /v1/image
Génère une image à partir d'une description textuelle : des images PNG de haute qualité en quelques secondes.
Paramètres (JSON body)
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| prompt | string | oui | Description de l'image à générer (2-1000 caractères). Ex: "a futuristic cityscape at night, neon lights" |
| negative_prompt | string | non | Éléments à éviter (défaut: "blurry, bad quality, deformed, ugly") |
| width | integer | non | Largeur en pixels (256-1024, défaut: 512) |
| height | integer | non | Hauteur en pixels (256-1024, défaut: 512) |
| steps | integer | non | Nombre de pas de débruitage (1-8, défaut: 4). Plus = meilleure qualité, plus lent. |
| seed | integer | non | Seed aléatoire pour reproduire un résultat. Null = aléatoire. |
Exemple
curl -X POST https://api.s33d.fr/v1/image \
-H "Content-Type: application/json" \
-H "Authorization: Bearer VOTRE_CLÉ" \
-d '{
"prompt": "a cyberpunk cat with neon glasses, digital art",
"width": 512,
"height": 512,
"steps": 4
}'
Réponse
{
"image_base64": "iVBORw0KGgo...",
"width": 512,
"height": 512,
"seed": 3089226572,
"format": "png",
"generation_time_ms": 3036
}
💡 Utilisation du résultat :
Le champ
image_base64 contient le PNG encodé en base64. Affichez-le directement avec <img src="data:image/png;base64,..."> ou décodez-le pour l'enregistrer en fichier.
🎯 Astuce — Seed reproductible :
Le
seed retourné permet de reproduire exactement la même image. Passez-le en paramètre dans un appel suivant pour obtenir un résultat identique.
🚀 Exemples d'intégration
🐍 Python
import requests, base64
resp = requests.post(
"https://api.s33d.fr/v1/image",
headers={"Authorization": "Bearer VOTRE_CLÉ"},
json={
"prompt": "watercolor painting of a forest",
"width": 768,
"height": 512
}
)
data = resp.json()
# Sauvegarder le fichier PNG
with open("output.png", "wb") as f:
f.write(base64.b64decode(data["image_base64"]))
📦 JavaScript
const res = await fetch(
"https://api.s33d.fr/v1/image",
{
method: "POST",
headers: {
"Authorization": `Bearer ${KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
prompt: "abstract geometric art, vibrant colors",
steps: 4
})
}
);
const { image_base64 } = await res.json();
// Afficher directement
document.getElementById("img").src =
`data:image/png;base64,${image_base64}`;