API MiniMax H3 Image
Référence API complète des modèles de génération d’images à partir de texte et de retouche d’images MiniMax H3 Image.
Variantes du modèle
Cette API prend en charge deux variantes du modèle :
Comparaison rapide
Rapports d’aspect pris en charge
1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9
Indiquez le rapport à l’aide de valeurs numériques distinctes pour width et height, et non de dimensions en pixels. Si les deux valeurs sont omises, le rapport est 1:1 par défaut ; sinon, indiquez les deux valeurs en utilisant l’une des paires d’entiers prises en charge.
MiniMax H3 Image (Génération d’images à partir de texte)
Point de terminaison
POST /api/v1/image/task
Authentification
Authorization: Bearer YOUR_API_KEY
Paramètres de la requête
Obligatoires
Facultatifs
Remarque : Le rapport width:height doit correspondre à l’un des 15 rapports pris en charge indiqués ci-dessus.
Exemple de requête
javascript
MiniMax H3 Image Edit (Retouche d’images)
Point de terminaison
POST /api/v1/image/task
Paramètres de la requête
Obligatoires
Facultatifs
Remarque : Le rapport width:height doit correspondre à l’un des 15 rapports pris en charge indiqués ci-dessus.
Exemple de requête
javascript
Exemple de retouche d’une seule image
javascript
Exemple de composition à partir de plusieurs images
javascript
Format de réponse
Réponse initiale
json
Réponse à l’interrogation périodique
Interrogez périodiquement GET /api/v1/image/{task_id} pour vérifier le statut. Les réponses réussies fournissent les URL des images générées dans data.task_result.images[].url.
Valeurs de statut
submitted: Tâche acceptéeprocessing: Génération d’image en courssucceed: Génération d’image terminéefailed: Échec de la génération d’image
Bonnes pratiques
- Instructions détaillées : Décrivez le sujet, l’éclairage et la composition, en limitant les instructions à 5000 caractères
- Choix de la résolution : Indiquez explicitement
1k,2kou4kdans chaque requête - Rapport d’aspect : Utilisez des valeurs de rapport appariées pour
widthetheight, ou omettez les deux pour obtenir1:1 - Qualité de la retouche : Fournissez 1-16 images de référence respectant les exigences de format et de dimensions prises en charge