MiniMax H3 Image Highspeed

Schnelles Beispiel

Sende eine Bildanfrage, speichere die zurückgegebene id und frage den Status ab, bis die Aufgabe completed oder failed ist. Diese API verwendet asynchrone Aufgaben und gibt Ergebnisse als URLs aus.

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"minimax-h3-image-highspeed","prompt":"An amber bottle on pale limestone in soft morning light","area":"1K","aspect_ratio":"3:2"}'

Endpunkt und Header

POST https://api.seedrouter.ai/v1/images/generations

Bewahre den Schlüssel auf deinem Server auf. Ein erfolgreicher HTTP-Status bestätigt die Annahme einer Aufgabe; er bedeutet nicht, dass das Bild fertig ist.

Parameter

Es gibt 13 akzeptierte Felder. Nur model und prompt sind erforderlich. Lasse optionale Felder weg, um Standardwerte zu verwenden; kein Feld akzeptiert null. Der Playground bietet das festgelegte Modell und zehn bearbeitbare Eingaben. Das URL-Antwortformat und die Aufgabenbereitstellung ohne Streaming sind festgelegt.

Abhängigkeiten von Größe und Prompt

Eine explizite size muss positive ganzzahlige Abmessungen mit einer Fläche zwischen 655.360 und 20.000.000 Pixeln einschließlich der Grenzwerte enthalten. Breite geteilt durch Höhe muss zwischen 1/3 und 3 liegen. Beispielsweise ist 2048x1152 gültig. Bei expliziten Abmessungen musst du sowohl aspect_ratio als auch area weglassen, selbst wenn ihr Wert auto wäre.

Wenn du die Größe weglässt oder auto verwendest, nutze aspect_ratio und area gemeinsam. Die Fläche ist eine Zielgröße; prüfe die gelieferte Datei auf die exakten Abmessungen. Sie entspricht keinem festen Preis pro Bild.

Die Einstellung disable_prompt_enhanced: true erfordert eine explizite Pixelgröße oder ein festes Seitenverhältnis. Bei deaktivierter Verbesserung liest das Modell ungefähr die ersten 4.096 Prompt-Tokens. Die Eingabegrenze von 32.000 Zeichen gilt weiterhin. Bei der Bearbeitung werden Prompts immer verbessert, daher wird true abgelehnt, wenn images vorhanden ist.

Felder für Maske, Seed, Stil, Qualität, negativen Prompt, Hintergrund oder eine separate Auflösung werden nicht akzeptiert. Unbekannte Parameter führen vor dem Absenden zu einem Fehler. Diese API bietet kein Streaming, keine base64-Bilder und keine WebP-Ausgabe.

Referenzbilder

Verwende öffentlich zugängliche HTTP(S)-URLs ohne eingebettete Zugangsdaten. Jedes Bild muss im Format JPEG, PNG, WebP, HEIC oder HEIF vorliegen, darf höchstens 64 MiB groß sein, muss auf jeder Seite 128–8.192 Pixel haben und darf ein Verhältnis der langen zur kurzen Seite von höchstens 4 aufweisen. Halte den JSON-Body bei höchstens 64 MiB. Bilddateien werden über URLs referenziert; ihre Bytes werden nicht in den JSON-Body eingebettet.

Weise jeder Referenz einen klaren Zweck zu und beschreibe, was unverändert bleiben soll. Die Reihenfolge im Array bestimmt <Picture 1>, <Picture 2> und so weiter.

{
  "model": "minimax-h3-image-highspeed",
  "prompt": "Use <Picture 1> as the product and <Picture 2> as the setting. Preserve the product's shape and label. Match the setting's light and perspective.",
  "images": [
    {"image_url": "https://example.com/product.jpg"},
    {"image_url": "https://example.com/setting.jpg"}
  ],
  "aspect_ratio": "3:2",
  "area": "2K",
  "n": 1,
  "output_format": "png"
}

Ersetze die Beispiel-URLs durch deine eigenen zugänglichen Bilddateien.

Abrechnung

Die Abrechnung umfasst drei Token-Kategorien: Texteingabe, Bildeingabe und Bildausgabe. Multipliziere die tatsächliche Nutzung jeder Kategorie mit ihrem aktuellen Tarif. Die Anzahl der Ausgaben, die Bildabmessungen und die Referenzbilder beeinflussen die Nutzung; Auflösungsbezeichnungen legen keinen festen Rechnungsbetrag fest. Fehlgeschlagene Anfragen werden nicht berechnet. Siehe aktuelle Preise.

Aufgabenantwort und Statusabfrage

Eine angenommene Anfrage gibt eine asynchrone Aufgabe zurück:

{"id":"task_example","model":"minimax-h3-image-highspeed","status":"processing"}

curl https://api.seedrouter.ai/v1/tasks/task_example \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Eine abgeschlossene Antwort enthält Bild-URLs in output.data. Jedes gelieferte Bild enthält seine size und kann revised_prompt (die verbesserte Beschreibung) enthalten. output.created ist die Erstellungszeit in Unix-Sekunden, und output.output_format kennzeichnet das gelieferte Format. output.usage stellt die Token-Anzahlen für Texteingabe, Bildeingabe und Bildausgabe sowie die Anzahl der gelieferten generated_images bereit. Die folgenden URLs und IDs dienen als Beispiele:

{
  "id": "task_example",
  "model": "minimax-h3-image-highspeed",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.jpg"}]}
}

Frage den Status alle 10–20 Sekunden ab. Ein Client-Timeout ist keine fehlgeschlagene Aufgabe: Bewahre ihre ID auf und frage den Status weiter ab, statt eine doppelte Anfrage zu senden. Öffentliche Antworten enthalten keine Kontostände oder Kosten.

Fehler

HTTP-Fehler verwenden {"error":{"code":integer,"message":string}}. Eine fehlgeschlagene Aufgabe hat status: "failed" und einen Fehler. Korrigiere ungültige Parameter, bevor du eine neue Anfrage sendest. Siehe das gemeinsame Fehlerverzeichnis und den Aufgabenlebenszyklus.

Verwandte Seiten

• MiniMax H3 Image Highspeed Playground und Preise
• MiniMax H3 Image