Diese Anleitung gibt es vorerst nur auf Englisch. →
Anfrageparameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
seed | Nein | Dieselbe Zahl liefert ein wiederholbares Ergebnis. ≥ 0 · ≤ 2147483647 |
size | Nein | Output 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 · Standardwert: 1024*1024 |
prompt | Ja | Describe the image as comma-separated tags: quality tags first, then subject and wardrobe, then lighting and lens. |
output_format | Nein | Dateiformat des Ergebnisses. png · jpeg · webp · Standardwert: png |
Preise
Die Preise sind in Credits angegeben, denselben Credits, die du auf der Website nutzt (1 Credit = 0,01 $). Beim Annehmen der Aufgabe wird der Betrag reserviert und nach Abschluss auf die tatsächlichen Kosten abgerechnet; fehlgeschlagene Aufgaben werden erstattet.
| Option | Credits pro Bild | ≈ USD |
|---|---|---|
| Standard | 2,25 | 0,023 $ |
Jede Aufgabe wird auf ganze Credits aufgerundet, ein Lauf in der günstigsten Stufe kostet also 3 Credits pro Bild (0,03 $).
Für eine exakte Zahl vor dem Start sendest du denselben Body an POST /jobs/quote.
API-Schnellstart
Die Prefect Pony XL API in drei Schritten aufrufen
- API-Schlüssel erstellen. Melde dich bei PopNow an und erstelle in der API-Konsole einen Schlüssel. Schlüssel beginnen mit sk-popnow- und nutzen dieselben Credits wie die Website.
- Anfrage senden. Sende POST /jobs/createTask mit model prefect/pony-xl/text-to-image und einem input-Objekt nach der Parametertabelle. Die Antwort enthält sofort eine Task-ID.
- Ergebnis abholen. Frage GET /jobs/recordInfo mit der Task-ID ab oder gib eine callBackUrl mit, dann schicken wir das Ergebnis dorthin. Lade die Ausgabelinks herunter, sobald die Aufgabe erfolgreich ist.
# 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"Ersetze den Prompt und alle Links durch deine eigenen. Im Tab „API“ findest du die Referenz zu Antwort, Polling und Callback.
Fragen zur Prefect Pony XL API
Was kostet die Prefect Pony XL API?
Prefect Pony XL kostet 3 Credits (0,03 $) pro Bild. Die Credits sind dieselben wie auf der Website (1 Credit = 0,01 $), neue Konten bekommen 30 Gratis-Credits, und fehlgeschlagene Tasks werden erstattet.
Wie lautet der Modellname von Prefect Pony XL in der API?
Trag prefect/pony-xl/text-to-image für Bild erstellen im Feld model von POST /jobs/createTask ein.
Wie schreibe ich die Prompts dafür?
Als Tags, kommagetrennt, Qualitäts-Tags zuerst. Das Modell wurde so trainiert, wie lokale SDXL-Checkpoints trainiert werden, die Prompt-Gewohnheiten aus diesem Ökosystem lassen sich also direkt übernehmen. Lange beschreibende Sätze funktionieren, steuern aber schwächer als Tags.
Kann ich dasselbe Bild ein zweites Mal bekommen?
Ja — übergeben Sie denselben Seed mit demselben Prompt und derselben Größe. Lassen Sie den Seed weg, liefert jeder Aufruf ein anderes Bild. Speichern Sie den Seed neben jedem Bild, das Sie später wieder herstellen können wollen.
Kann ich ein Referenzbild mitschicken?
Nein. Dieser Endpunkt ist reines Text-to-Image; es gibt keine Bildeingabe, kein Inpainting und keine Konditionierung im Stil von ControlNet. Für bildgesteuerte Bearbeitungen nehmen Sie einen der Image-to-Image-Endpunkte aus dem Katalog.
Welche Größen gibt es, und warum gerade diese?
Sieben Größen, alle in den nativen Pixelmaßen von SDXL: 1024*1024, 896*1152, 1152*896, 832*1216, 1216*832, 768*1344 und 1344*768. Ein Format außerhalb der trainierten Seitenverhältnisse zu verlangen ist bei SDXL-Modellen genau der Punkt, an dem die Anatomie auseinanderfällt. Deshalb legt der Endpunkt die trainierten Formate offen statt beliebiger Breite und Höhe.
Welche Limits hat die Prefect Pony XL API?
Prompt-Länge (Zeichen): 5,000. Anfragen außerhalb dieser Grenzen werden abgelehnt, bevor etwas abgebucht wird.
Kann ich Prefect Pony XL testen, ohne Code zu schreiben?
Ja. Der Playground führt Prefect Pony XL mit deinen PopNow-Credits aus, braucht keinen API-Schlüssel und zeigt dir zu jedem Lauf den passenden Code.

