Introduction
Développer une création
Bloom enrichit la création pendant l’agrandissement. En l’absence de preset, le modèle bloom_2 est employé.
Requête Bloom
Choisissez 2k, 4k ou 8k, avec 4k par défaut. La créativité démarre à 3 et le prompt reste facultatif.
Limites créatives
Contrôlez les nouveaux visages et textures dans le JPEG ou PNG. Realism refuse une créativité supérieure à 4.
| Champ | Valeur |
|---|---|
| Entrée | Image |
| Sortie | Image |
| Modèle initial |
|
| Autres choix |
|
| Résolution initiale | 4K |
| Guidage facultatif |
|
| Fichier livré | JPEG ou PNG |
Fonctionnalités et points forts
Bloom 2 donne plus de texture à la peau
Sans prompt, avec une créativité de 3, Bloom 2 reconstruit yeux, barbe et texture cutanée. Le résultat de droite interprète le visage ; il ne prouve pas les détails réellement capturés par l’appareil.
Comparer les modèles sur un même visage
De gauche à droite : Bloom 2, Bloom Realism et Bloom. Bloom 2 est plus texturé, Realism dessine un visage plus net avec de légers changements, Bloom reste plus doux dans cet essai. Durées observées : environ 86, 134 et 273 secondes.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
image_url | Oui | L’image existante dont Bloom va développer et réinterpréter la composition. 1 caractères minimum |
preset | Non |
|
resolution | Non | Palier Bloom |
prompt | Non | Description facultative de la scène ou du rendu pour guider les nouveaux détails. 2000 caractères maximum |
creativity | Non | Entier de 1–9, valeur initiale 3 : 1 reste proche de la source, 9 ajoute le plus de détails. |
output_format | Non | Téléchargez la création Bloom en |
Tarification
Pour Bloom, seul resolution change le tarif par image. Preset, prompt, créativité et choix entre JPEG et PNG n’ont aucune incidence sur ce prix.
| Spécification | Prix |
|---|---|
| $0.36 / image |
| $1.08 / image |
| $4.08 / image |
Cas d’utilisation
Faire évoluer une illustration
Agrandissez une œuvre en laissant apparaître de nouvelles textures et décrivez le rendu souhaité dans prompt.
Rechercher un rendu photographique
Choisissez bloom_realism avec creativity entre 1 et 4 pour une interprétation naturelle.
Guide de prompt et conseils pratiques
Apporter une création
Indiquez l’image existante à développer dans
image_url.Orienter le rendu
Sélectionnez preset et créativité ; ajoutez éventuellement une description de la scène ou de la finition.
Examiner la nouvelle version
Fixez le palier, puis vérifiez que les visages et les détails ajoutés conviennent à votre œuvre.
Développer une création
Bloom agrandit une image existante en inventant des détails guidés par le preset, la créativité et un prompt facultatif.
Requête Bloom
{
"image_url": "https://example.com/blurred-portrait.jpg",
"preset": "bloom_2",
"resolution": "2k",
"creativity": 3,
"output_format": "jpeg"
}
Choisir une interprétation
preset | Orientation visuelle |
|---|---|
bloom_2 | Dernier modèle créatif, sélectionné par défaut |
bloom | Illustration, art et images de synthèse |
bloom_realism | Aspect photographique naturel ; créativité limitée à 1–4 |
Essai sur portrait
Sans prompt, avec une créativité de 3, Bloom 2 reconstruit yeux, barbe et texture cutanée. Le résultat de droite interprète le visage ; il ne prouve pas les détails réellement capturés par l’appareil.
De gauche à droite : Bloom 2, Bloom Realism et Bloom. Bloom 2 est plus texturé, Realism dessine un visage plus net avec de légers changements, Bloom reste plus doux dans cet essai. Durées observées : environ 86, 134 et 273 secondes.
Limites créatives
Bloom invente volontairement des détails et peut modifier visages, textures et petits objets. creativity doit être un entier de 1–9 ; avec bloom_realism, seuls 1–4 sont admis. Les valeurs supérieures sont refusées pour Realism. La durée varie selon la source et le modèle.
Démarrage rapide de l’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "topaz/bloom/upscale",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"preset": "bloom_2",
"resolution": "4k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
