Guide : générer et retoucher des images

Créer des images à partir de texte, retoucher des photos avec des images de référence et utiliser les outils de détourage, d’agrandissement et de nettoyage — choix des modèles et coûts compris.

Les images sont ce qu’il y a de plus rapide et de moins cher à générer : c’est le meilleur terrain pour apprendre l’API. La plupart des modèles d’image terminent en moins d’une minute, vous pouvez donc utiliser ?wait=60 et récupérer l’image dans la même réponse.

Texte vers image

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model": "black-forest-labs/flux-2-klein-9b/text-to-image",
    "input": {
      "prompt": "Product photo of a ceramic coffee mug on a linen tablecloth, soft window light, shallow depth of field",
      "aspect_ratio": "4:3"
    }
  }'

Le résultat est dans data.output.assets[0].url. Si la réponse est un 202, le modèle a eu besoin de plus de 60 secondes ; lisez alors la tâche avec recordInfo.

Quel modèle choisir

Vous voulez	Essayez	Pourquoi
Des brouillons très rapides et bon marché	`alibaba/z-image-turbo/text-to-image`	Une dizaine de secondes et un ou deux crédits par image
Une bonne qualité générale à petit prix	`black-forest-labs/flux-2-klein-9b/text-to-image`	Rapide, net, suit bien les prompts
Du texte lisible, des affiches, des schémas	`google/nano-banana-2.1/text-to-image`, `openai/gpt-image-2/text-to-image`	Excellents en typographie et en mise en page ; jusqu’en 4K
Plusieurs propositions en un appel	Les modèles avec `num_outputs`	Une tâche, plusieurs images

Les prix varient selon le modèle et les options. Modèles indique le prix de départ de chacun ; sa page de référence liste tous les paliers.

Retoucher avec des images de référence

Les modèles de retouche se terminent par /edit et prennent les images sources dans image_urls, dans l’ordre où votre prompt les mentionne :

{
  "model": "google/nano-banana-2.1/edit",
  "input": {
    "prompt": "Turn the scene into a bright summer afternoon and keep the composition",
    "image_urls": ["https://media.popnow.ai/movie/lighthouse.webp"]
  }
}

Dites ce qui doit rester identique autant que ce qui doit changer ; les modèles de retouche prennent « garde le visage et la pose » au pied de la lettre.
Avec plusieurs références, désignez-les par leur position : « mets la veste de la deuxième image sur la personne de la première ».
Les fichiers locaux passent d’abord par un envoi ; les fichiers réutilisés ont leur place dans votre bibliothèque de ressources.

Outils en un clic

Les outils de PopNow prennent une seule image et n’ont pas besoin de prompt :

Identifiant	Rôle
`popnow/background-remover-v1/edit`	Détoure le sujet sur un fond transparent
`popnow/image-upscaler-v1/upscale`	Agrandit et affine une image
`popnow/object-eraser-v1/edit`	Efface un objet que vous désignez
`popnow/image-expander-v1/edit`	Prolonge l’image au-delà de ses bords

{ "model": "popnow/background-remover-v1/edit",
  "input": { "image_url": "https://media.popnow.ai/movie/lighthouse.webp" } }

Les réglages qui comptent

aspect_ratio et resolution sont les deux réglages qui changent le plus souvent le prix. Dans le doute, demandez à jobs/quote.
seed : si vous l’omettez, une valeur aléatoire est choisie et renvoyée dans l’input de la tâche. Renvoyez ce nombre pour obtenir une variante proche d’un résultat qui vous plaît ; une seed fixe rend les essais comparables, sans promettre une image identique.
output_format : png conserve la transparence et les détails ; jpeg est plus léger.
Les réglages inconnus sont refusés : consultez le schéma du modèle plutôt que de reprendre les réglages d’un autre.

Des prompts qui marchent

Décrivez l’image comme vous briefez un photographe ou un illustrateur : sujet, décor, composition, lumière, style. « Une tasse en céramique, vue du dessus, sur une nappe en lin, lumière du matin, couleurs sourdes » vaut mieux que « une jolie photo de tasse ». Placez l’essentiel en premier et évitez les longues listes de mots de style qui tirent dans des directions opposées.

Les erreurs possibles

content_rejected — le modèle a refusé le prompt ou la référence. Reformulez ou essayez un autre modèle.
invalid_asset — une référence n’a pas pu être lue. Vérifiez que l’URL renvoie bien l’image, ou envoyez le fichier.
unsupported_combination — ce modèle ne gère pas ce mélange de réglages pour l’instant ; modifiez celui cité dans le message.

Toutes libèrent la réservation : une image en échec ne coûte rien.