Einführung
P-H3-Image Text-zu-Bild macht aus Ihrer Szenenbeschreibung ein einzelnes Standbild. Pruna AI veröffentlichte die offenen Modellgewichte am 3. November 2026 und passte dafür MiniMax H3 für Bilderzeugung und Bildbearbeitung an.
Wichtige Funktionen und Highlights
Wählen Sie 1k, 1.5k, 2k, 3k oder 4k unabhängig von den 15 Seitenverhältnissen. In unseren Tests lieferte die Einstellung 4k bei 16:9 ein Bild mit 5472 x 3072 Pixeln. Als Ausgabe sind JPEG, PNG und WebP möglich.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Erforderliche Szenenbeschreibung ohne vorgegebenen Text. Beschreiben Sie Kleidung, Umgebung und Licht knapp, statt viele Adjektive aufzulisten. mindestens 1 Zeichen · höchstens 5000 Zeichen |
aspect_ratio | Nein | Wählen Sie aus 15 Formaten: 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. |
resolution | Nein | Wählen Sie 1k (Standard, etwa 1 MP), 1.5k (~2,4 MP), 2k (~4 MP), 3k (~9,4 MP) oder 4k (~16,8 MP). Dieses Feld bestimmt die berechnete Größenstufe. |
output_format | Nein | Die Dateikodierung ist standardmäßig jpeg; png und webp werden ebenfalls unterstützt. Die Wahl der Kodierung verursacht keine Zusatzgebühr. |
seed | Nein | Optionale Einstellung der Zufallsbasis ohne vorgeschriebenen festen Wert. |
Preis
Jedes erzeugte Bild wird nach der gewählten Größenstufe berechnet: 1k, 1.5k, 2k, 3k oder 4k. Seitenverhältnis und Format kosten keinen Aufpreis. Im Bearbeitungsmodus fällt für jedes Eingabebild nach dem ersten eine kleine Zusatzgebühr an. Fehlgeschlagene Anfragen kosten nichts.
| Spezifikation | Preis |
|---|---|
| $0.024 / Bild |
| $0.036 / Bild |
| $0.048 / Bild |
| $0.096 / Bild |
| $0.144 / Bild |
Anwendungsfälle
Beschreiben Sie Szenen für redaktionelle Porträts, Filmstills im Diner oder kurze Neonschilder. Für Änderungen an vorhandenen Bildern wählen Sie Bildbearbeitung.
Prompt-Leitfaden und Praxistipps
Nennen Sie Motiv, Kleidung, Ort und Lichtquelle. Laut Pruna AI können kurze Wörter in Anführungszeichen gelingen; längere Passagen und kleine Schrift können jedoch zu fehlerhaftem Text werden. Behalten Sie seed bei und ändern Sie ein Element, um Ergebnisse zu vergleichen; die Ausgabe wird dadurch nicht festgeschrieben. In unseren Tests benötigten höhere Stufen mehr Zeit, eine 4k-Generierung erreichte 241 Sekunden reine Modelllaufzeit.
API-Schnellstart
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "pruna-ai/p-h3-image/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.
