prefect/pony-xl/text-to-imageÀ partir de 3 crédits par image

Prefect Pony XL est un checkpoint anime communautaire issu de la lignée Pony XL, publié ici sous la forme d’un endpoint text-to-image unique. Il accepte un prompt de 5 000 caractères, sept tailles natives SDXL, une graine facultative et le choix entre JPEG, PNG et WebP.

Appelez-le avec le nom de modèle prefect/pony-xl/text-to-image sur POST /jobs/createTask, à partir de 3 crédits par image (0,03 $US). Les nouveaux comptes reçoivent 30 crédits gratuits pour l’essayer d’abord dans le Playground.

  • Créer une image

Ce guide n'est disponible qu'en anglais pour le moment. →

Paramètres de requête

ParamètreRequisDescription
seedNonLe même nombre donne un résultat reproductible. ≥ 0 · ≤ 2147483647
sizeNonOutput image size in pixels, written as width*height. All values are native SDXL shapes. 1024*1024 · 896*1152 · 1152*896 · 832*1216 · 1216*832 · 768*1344 · 1344*768 · Par défaut: 1024*1024
promptOuiDescribe the image as comma-separated tags: quality tags first, then subject and wardrobe, then lighting and lens.
output_formatNonLe type de fichier du résultat. png · jpeg · webp · Par défaut: png

Tarifs

Les prix sont en crédits, les mêmes que ceux que vous utilisez sur le site (1 crédit = 0,01 $). Le montant est réservé à l'acceptation de la tâche, puis réglé au coût réel à la fin ; les tâches en échec sont remboursées.

OptionCrédits par image≈ USD
Standard2,250,023 $US

Chaque tâche est arrondie au crédit entier supérieur : une exécution au palier le plus bas coûte donc 3 crédits par image (0,03 $US).

Pour obtenir un montant exact avant de lancer, envoyez le même corps à POST /jobs/quote.

Démarrage rapide de l'API

Appeler l’API Prefect Pony XL en trois étapes

  1. Créer une clé API. Connectez-vous à PopNow et créez une clé dans la console API. Les clés commencent par sk-popnow- et utilisent les mêmes crédits que le site.
  2. Envoyer la requête. Envoyez POST /jobs/createTask avec model prefect/pony-xl/text-to-image et un objet input conforme au tableau des paramètres. La réponse renvoie aussitôt un ID de tâche.
  3. Récupérer le résultat. Interrogez GET /jobs/recordInfo avec l’ID de tâche, ou passez une callBackUrl et nous y envoyons le résultat. Téléchargez les liens de sortie quand la tâche réussit.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "prefect/pony-xl/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "size": "1024*1024",
    "output_format": "png"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Remplacez le prompt et les liens par les vôtres. L'onglet API contient la référence pour la réponse, le polling et le callback.

Questions sur l’API Prefect Pony XL

Combien coûte l’API Prefect Pony XL ?

Prefect Pony XL coûte 3 crédits (0,03 $US) par image. Les crédits sont les mêmes que sur le site (1 crédit = 0,01 $), les nouveaux comptes reçoivent 30 crédits offerts et les tâches échouées sont remboursées.

Quel est le nom de modèle de Prefect Pony XL dans l’API ?

Indiquez prefect/pony-xl/text-to-image pour Créer une image dans le champ model de POST /jobs/createTask.

Comment écrire les prompts ?

En tags, séparés par des virgules, tags de qualité en premier. Le modèle a été entraîné comme le sont les checkpoints SDXL locaux : les habitudes de prompt de cet écosystème se transposent directement. Les longues phrases descriptives fonctionnent, mais dirigent moins bien que les tags.

Puis-je obtenir deux fois la même image ?

Oui — passez la même graine avec le même prompt et la même taille. Sans la graine, chaque appel renvoie une image différente. Conservez la graine à côté de toute image que vous voudrez pouvoir reconstruire.

Puis-je envoyer une image de référence ?

Non. Cet endpoint fait uniquement du text-to-image : ni entrée image, ni inpainting, ni conditionnement de type ControlNet. Pour des retouches pilotées par une image, utilisez l’un des endpoints image-to-image du catalogue.

Quelles tailles sont disponibles, et pourquoi celles-là ?

Sept tailles, toutes aux définitions natives de SDXL : 1024*1024, 896*1152, 1152*896, 832*1216, 1216*832, 768*1344 et 1344*768. Demander un ratio hors entraînement à un modèle SDXL, c’est précisément là que l’anatomie se défait ; l’endpoint expose donc les formats entraînés plutôt qu’une largeur et une hauteur libres.

Quelles sont les limites de l’API Prefect Pony XL ?

Longueur du prompt (caractères): 5,000. Les requêtes hors de ces limites sont refusées avant tout débit.

Puis-je essayer Prefect Pony XL sans écrire de code ?

Oui. Le Playground lance Prefect Pony XL avec vos crédits PopNow, sans clé API, et affiche le code correspondant à chaque génération.

Tous les modèles Prefect Pony XL

En savoir plus sur Prefect Pony XL