PopNowDocs API
Contenu principal

Référence API de MiniMax H3 Image LoRA

Images fixes et retouches H3 avec jusqu’à trois de tes LoRA

Une seule clé API PopNow suffit pour appeler MiniMax H3 Image LoRA depuis votre code. Vous trouverez ici les identifiants de modèle à envoyer, chaque champ d’entrée accepté, le coût d’une requête en crédits et une requête à coller telle quelle dans un terminal.

Les descriptions des paramètres proviennent du schéma d’entrée du modèle et ne sont disponibles qu’en anglais.

En bref

Éditeur
MiniMax
Résultat
Image
À partir de
6.3 crédits par image ($0.063)
Durée habituelle
environ 13 s

1 crédit = 0,01 $. À l’acceptation, une tâche réserve le montant maximal possible, puis facture la consommation réelle à la fin, arrondie au crédit supérieur ; le reste est libéré. Une tâche en échec n’est pas facturée. Pour connaître le montant exact avant de lancer, appelez POST /api/v1/jobs/quote.

Créer une image

minimax/h3-image-lora/text-to-image

Prix

OptionCrédits (par image)Dollars US
1k6.3$0.063
2k13.5$0.135

Paramètres

ChampTypeValeur par défautValeurs admisesRôle
promptObligatoirestring—jusqu’à 5 000 caractèresDescribe the subject, composition and lighting.
aspect_ratioFacultatifstring1:11:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3, 5:4, … (+1)Output aspect ratio.
resolutionFacultatifstring1k1k, 2kOutput resolution tier: 1k is about one megapixel, 2k about four.
lorasFacultatifarray<object>[]jusqu’à 3 élémentsUp to three LoRA weight files trained for MiniMax H3, each with its own strength.
output_formatFacultatifstringjpegjpeg, png, webpContainer of the returned image.
seedFacultatifinteger—de 0 à 2147483647Random seed for controlled comparisons.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

POST /api/v1/jobs/createTask?wait=60
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": "minimax/h3-image-lora/text-to-image",
  "input": {
    "prompt": "A cozy reading nook beside a rain-streaked window, warm lamp light, a sleeping orange cat on a knitted blanket, soft film grain",
    "resolution": "1k"
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Modifier une image

minimax/h3-image-lora/edit

Prix

OptionCrédits (par image)Dollars US
1k8.1$0.081
2k18.9$0.189

Paramètres

ChampTypeValeur par défautValeurs admisesRôle
promptObligatoirestring—jusqu’à 5 000 caractèresSay what to change. Refer to the references as <Picture 1>, <Picture 2> and so on.
image_urlsObligatoirearray<string (uri)>—jusqu’à 9 élémentsOne to nine reference images. Each one after the first raises the quote.
aspect_ratioFacultatifstring—1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3, 5:4, … (+1)Output aspect ratio. Leave it unset to follow the first reference image.
resolutionFacultatifstring1k1k, 2kOutput resolution tier: 1k is about one megapixel, 2k about four.
lorasFacultatifarray<object>[]jusqu’à 3 élémentsUp to three LoRA weight files trained for MiniMax H3, each with its own strength.
output_formatFacultatifstringjpegjpeg, png, webpContainer of the returned image.
seedFacultatifinteger—de 0 à 2147483647Random seed for controlled comparisons.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

L’exemple utilise des fichiers d’exemple PopNow dans image_urls. Remplacez-les par vos propres liens HTTPS publics, fichiers envoyés ou ressources enregistrées.

POST /api/v1/jobs/createTask?wait=60
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": "minimax/h3-image-lora/edit",
  "input": {
    "prompt": "Change the orange jacket to deep forest green and add soft golden-hour light; keep the face, pose and background unchanged",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ],
    "resolution": "1k"
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Pour aller plus loin

Sur cette page