ToAPIs
    StartseiteToAPIs
    BildgenerierungGPT Image 2.6, Gemini, FLUX…VideogenerierungSeedance, Veo, Kling, Sora…Chat & TextGPT-5.6, Claude, DeepSeek…Sprache & MusikVoiceover, TTS, Audio
    Neu erschienenSeedance 2.5
    PreiseAPI-DokumentationMCP
    BlogAlternativen
    AnmeldenKostenlos starten
    Alle ModellePreiseAPI-DokumentationMCPBlogAlternativen
    AnmeldenKostenlos starten

    Sprache

    Esc
    • Seedance 2.5Videogenerierung
    • GPT Image 2Bildgenerierung
    • GPT Image 2.6Bildgenerierung
    • GPT Image 2.5Bildgenerierung
    • Veo 3.1 FastVideogenerierung
    • Kling 3.0 TurboVideogenerierung
    • Kling V4 FlashVideogenerierung
    • Grok Video 1.5Videogenerierung
    • Nano Banana 2Bildgenerierung
    • Seedream 5.5Bildgenerierung
    • FLUXBildgenerierung
    • Sora 2Videogenerierung
    • Alle BildmodelleKategorie
    • Alle VideomodelleKategorie
    • GPT-5.6 SolChat & Codierung
    • Claude Opus 4.8Chat & Codierung
    • Claude Opus 4.7Chat & Codierung
    • DeepSeek V4 ProDeepSeek · Text
    • Gemini Omni 1.1 FlashGoogle · Multimodal
    1. Startseite
    2. Blog
    3. Tutorial
    4. Native 4K-Bilder mit GPT Image 2 erzeugen: Seitenverhältnisse und Upscaling-Workflows
    Zurück zu allen Beiträgen
    tutorial2026-11-126 Min. Lesezeit

    Native 4K-Bilder mit GPT Image 2 erzeugen: Seitenverhältnisse und Upscaling-Workflows

    Erzeugen Sie native 4K-Ausgaben mit dem aktuellen GPT Image 2-Vertrag: size als Seitenverhältnis und resolution als 4k. Ein dokumentiertes upscale: true-Flag gibt es nicht, und die 4K-Pixelgröße hängt vom gewählten Verhältnis ab.

    ToAPIs Engineering & Evaluation Team
    GPT Image 24KAspect RatioImage APITutorial
    TL;DR - Wichtigste Punkte
    • Das exakte gpt-image-2 führt Auflösung als eigene Stufe: 1k, 2k und 4k. Fordern Sie natives 4K an, indem Sie resolution: "4k" an POST /v1/images/generations senden — nicht ein serverseitiges upscale: true-Flag und auch keine Pixelzeichenkette wie 1024x1024.
    • size ist ein Seitenverhältnis (1:1, 16:9 und die weiteren dokumentierten Verhältnisse). Die API-Referenz veröffentlicht eine Pixeltabelle: Ein 16:9-Bild in 4k ist 3840x2160, ein 1:1-Bild in 4k ist 2880x2880.
    • Der aktuelle Playground lässt 5:4 und 4:5 bei 4K-Auflösung weg, obwohl die size-Tabelle der API Pixelwerte für diese beiden Verhältnisse listet. Prüfen Sie das an der Live-Referenz, wenn Sie sie benötigen.
    • Aufgaben laufen asynchron: Speichern Sie die Task-id und fragen Sie GET /v1/images/generations/{id} ab. Ein Client-Timeout ist kein Beweis dafür, dass die Aufgabe fehlgeschlagen ist – besonders bei 4k.
    • Kalkulieren Sie nicht mit älteren Stückpreisen für 1024px / 2048px. Bestätigen Sie den aktuellen Stufentarif für die exakte Modell-ID Ihres Kontos.

    Native 4K-Bilder mit GPT Image 2 erzeugen: Seitenverhältnisse und Upscaling-Workflows

    Zielmodell: gpt-image-2
    Inferenz-Endpunkt: https://api.toapis.com/v1/images/generations
    Verwandt: GPT Image 2 API-Leitfaden · Inpainting und Outpainting · Globaler Mirror und Proxy · API-Referenz zu Größen


    1. TL;DR und Leistungsüberblick

    • Aufgabe: Ein druck- oder hero-taugliches Bild auf der dokumentierten 4K-Stufe erzeugen, mit dem Seitenverhältnis, das Sie tatsächlich brauchen – aus einer einzigen gpt-image-2-Anfrage.
    • Vertrag: POST /v1/images/generations mit der Modell-ID gpt-image-2. size ist ein Seitenverhältnis (1:1, 16:9 und die weiteren dokumentierten Verhältnisse). resolution ist 1k, 2k oder 4k. Die offizielle Referenz veröffentlicht die resultierenden Pixelmaße für jedes Paar.
    • Was Sie nicht senden sollten: size: "2048x2048", ein quality: "hd"-Flag bei exaktem gpt-image-2 oder ein erfundenes upscale: true-Feld, das ein 2048-px-Rendering in 3840x2160 verwandeln soll. 4K ist ein eigenständiger resolution-Wert.
    • Asynchrones Protokoll: Der Submit-Aufruf gibt eine Task-id zurück. Fragen Sie GET /v1/images/generations/{id} (oder GET /v1/tasks/{id}) ab, bis der Status completed oder failed lautet. 4K-Aufgaben können länger dauern als 1K-Entwürfe; ein Client-Timeout ist kein Beweis dafür, dass die Aufgabe fehlgeschlagen ist.
    • FinOps: Entwerfen Sie in 1k, heben Sie akzeptierte Prompts auf 4k und bestätigen Sie den aktuellen Stufentarif. Übernehmen Sie keine älteren Preiszeilen für 1024 px / 2048 px in eine Prognose.

    2. Seitenverhältnisse, Auflösungsstufen und native 4K-Ausgabe

    Der aktuelle gpt-image-2-Vertrag trennt Form von Stufe. size wählt das Seitenverhältnis; resolution wählt die Qualitätsstufe; der Dienst leitet Breite und Höhe in Pixeln aus beiden ab. Deshalb ist ein „4K-Bild" nicht immer 3840x2160 — diese Größe ist das dokumentierte Ergebnis von size: "16:9" plus resolution: "4k". Eine quadratische 4K-Ausgabe ist als 2880x2880 dokumentiert.

    Die in der offiziellen Referenz gelisteten voreingestellten Verhältnisse sind:

    1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 2:1, 1:2, 21:9, 9:21

    Sie können auto senden und den Upstream-Anbieter wählen lassen, aber dann sind das endgültige Verhältnis und die Pixelgröße nicht garantiert. Exaktes gpt-image-2 dokumentiert kein custom-Feld für Pixelgrößen; benutzerdefinierte width:height-Verhältnisse (zum Beispiel 7:4) sind bei gpt-image-2-vip und gpt-image-2-official dokumentiert, vorbehaltlich deren eigener Grenzen (Seiten als Vielfache von 16, lange Kante maximal 3.840 px, Verhältnis maximal 3:1, Gesamtpixel zwischen 655.360 und 8.294.400).

    Die Größe-Tabelle der API-Referenz für exaktes gpt-image-2 lautet:

    size1k2k4k
    1:11024x10242048x20482880x2880
    3:21536x10242048x13603520x2336
    2:31024x15361360x20482336x3520
    4:31024x7682048x15363312x2480
    3:4768x10241536x20482480x3312
    5:41280x10242560x20483216x2576
    4:51024x12802048x25602576x3216
    16:91536x8642048x11523840x2160
    9:16864x15361152x20482160x3840
    2:12048x10242688x13443840x1920
    1:21024x20481344x26881920x3840
    21:92016x8642688x11523840x1648
    9:21864x20161152x26881648x3840

    Zwei Hinweise gehören neben diese Tabelle:

    • Der aktuelle ToAPIs Playground behält 3:2 und 2:3 bei 4K, lässt aber 5:4 und 4:5 bei 4K-Auflösung weg. Die obige Größe-Tabelle listet für diese beiden Verhältnisse weiterhin 4k-Pixel. Wenn Ihr Produkt 5:4 oder 4:5 in 4k benötigt, bestätigen Sie das mit einer Live-Anfrage, statt anzunehmen, das Playground-Gate sei das API-Limit.
    • In verschiedenen Oberflächen erscheinen Kleinschreibung (4k) und Großschreibung (4K). Offizielle gpt-image-2-Beispiele verwenden Kleinschreibung; die Playground-Konfiguration verwendet 1K / 2K / 4K. Folgen Sie in Clients der API-Referenz und behandeln Sie Groß-/Kleinschreibung nicht als zweiten Parameter.

    Ein grobes 2-gegen-2-Knotenraster, das durch ein hexagonales Gateway in ein feineres Raster mit hoher Auflösung fließt

    Abbildung 1: Auflösung ist ein eigenständiges Anfragefeld. Der dokumentierte Weg ist, direkt 4k anzufordern, nicht ein erfundener Post-Processing-Upscaler-Flag.

    Es gibt keinen dokumentierten ToAPIs-Schalter upscale: true, der ein natives 2048-px-Rendering nimmt und 3840x2160 zurückgibt. Wenn Sie bereits ein 1K- oder 2K-Bild haben und ein größeres wollen, ist der unterstützte Weg eine neue Generierung (optional mit dem Entwurf in reference_images) bei resolution: "4k". Versprechen Sie keine Typografie-Treue, keine „300-DPI-Druckvorlagen" und kein artefaktfreies Upscaling, solange Sie diese Eigenschaften nicht an Ihren eigenen Assets gemessen haben.

    Exaktes gpt-image-2 akzeptiert außerdem optional background: "transparent" und bis zu 14 reference_images-URLs. quality wird im aktuellen Playground-Vertrag nicht exponiert; quality ist ein Feld bei IDs wie gpt-image-2-vip.


    3. Umsetzung in der Produktion: cURL und Python

    Die internationalen Beispiele dieser Reihe verwenden https://api.toapis.com. Die offizielle Dokumentation empfiehlt Nutzern in Festlandchina https://toapis.cn. Behalten Sie einen Origin pro Umgebung bei.

    Schritt 1: cURL-Versand mit nativem 4K

    bash
    curl -X POST "https://api.toapis.com/v1/images/generations" \
      -H "Authorization: Bearer $TOAPIS_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "gpt-image-2",
        "prompt": "Wide architectural photograph of a concrete pavilion at dusk, still water in the foreground, no typography, no logos",
        "size": "16:9",
        "resolution": "4k",
        "n": 1,
        "response_format": "url"
      }'
    

    Diese Anfrage zielt dokumentiert auf 3840x2160. Für ein quadratisches 4K-Master ändern Sie size auf 1:1 (dokumentiert als 2880x2880). Für einen 9:16-Story-Frame verwenden Sie size: "9:16" (dokumentiert als 2160x3840).

    Schritt 2: Python-Helfer für Entwurf und Beförderung

    Iterieren Sie in 1k, speichern Sie den akzeptierten Prompt (und optionale Referenz-URLs) und senden Sie dann erneut in 4k. Der Poll-Helfer entspricht dem asynchronen Vertrag aus dem Mirror- und Proxy-Leitfaden.

    python
    import os
    import time
    import requests
    
    API_KEY = os.environ["TOAPIS_API_KEY"]
    BASE = "https://api.toapis.com"
    ENDPOINT = f"{BASE}/v1/images/generations"
    HEADERS = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json",
    }
    
    
    def dispatch_image(
        prompt: str,
        size: str = "16:9",
        resolution: str = "1k",
        model: str = "gpt-image-2",
        reference_images: list[str] | None = None,
    ) -> str:
        payload = {
            "model": model,
            "prompt": prompt,
            "size": size,
            "resolution": resolution,
            "n": 1,
            "response_format": "url",
        }
        if reference_images:
            payload["reference_images"] = reference_images
        res = requests.post(ENDPOINT, headers=HEADERS, json=payload, timeout=30)
        res.raise_for_status()
        data = res.json()
        task_id = data.get("id") or data.get("task_id")
        if not task_id:
            raise RuntimeError(f"Unexpected submission envelope: {data}")
        return task_id
    
    
    def poll_image_task(task_id: str, deadline_s: int = 300) -> str:
        poll_url = f"{BASE}/v1/images/generations/{task_id}"
        interval = 2.0
        start = time.time()
        while time.time() - start < deadline_s:
            time.sleep(interval)
            poll = requests.get(poll_url, headers=HEADERS, timeout=15)
            if poll.status_code == 429:
                retry_after = poll.headers.get("Retry-After")
                time.sleep(float(retry_after) if retry_after else min(interval * 2, 20))
                continue
            poll.raise_for_status()
            data = poll.json()
            status = data.get("status")
            if status == "completed":
                return data["result"]["data"][0]["url"]
            if status == "failed":
                raise RuntimeError(f"Generation failed: {data.get('error')}")
            interval = min(interval * 1.5, 8.0)
        raise TimeoutError(
            f"Task {task_id} exceeded {deadline_s}s; check status before retrying"
        )
    
    
    if __name__ == "__main__":
        prompt = (
            "Wide architectural photograph of a concrete pavilion at dusk, "
            "still water in the foreground, no typography, no logos"
        )
        draft_id = dispatch_image(prompt, size="16:9", resolution="1k")
        print("Draft:", draft_id, poll_image_task(draft_id))
        final_id = dispatch_image(prompt, size="16:9", resolution="4k")
        print("4K:", final_id, poll_image_task(final_id, deadline_s=300))
    

    Geben Sie 4K-Abfragen eine längere Frist als 1K-Entwürfen. Speichern Sie die Task-id sofort, damit ein Client-Timeout später durch eine Statusabfrage aufgelöst werden kann. Wenn Sie den Client später auf gpt-image-2-vip (benutzerdefinierte Verhältnisse, quality) oder gpt-image-2-official umstellen, ändern Sie jeweils eine Variable und lesen Sie die Referenz dieser ID erneut — Abrechnungseinheiten sind nicht automatisch identisch.


    4. Fehlerbehandlung und Statusmatrix

    Die folgenden Kategorien sind diagnostische Ausgangspunkte, keine Garantie für exakte ToAPIs-Fehlercodes. Ein erfolgreicher HTTP-Submit erfordert trotzdem, dass Sie den Task-status lesen.

    HTTP-StatusHäufige KategorieEmpfohlene Maßnahme
    400Ungültiges Feld oder nicht unterstützte KombinationPrüfen Sie, ob size ein dokumentiertes Verhältnis ist, ob resolution 1k / 2k / 4k ist und ob Sie eine Pixelzeichenkette wie 2048x2048 oder ein undokumentiertes upscale-Flag gesendet haben
    401Fehlender oder ungültiger API-SchlüsselRotieren Sie den Schlüssel im ToAPIs Dashboard und bestätigen Sie den Authorization-Header
    429Rate- oder ParallelitätslimitBeachten Sie Retry-After, wenn vorhanden; verwenden Sie Backoff mit Jitter; wiederholen Sie nur, wenn es sicher ist
    5xx oder Netzwerk-TimeoutVorübergehendes Gateway- oder Upstream-ProblemPrüfen Sie den Task-Status vor erneutem Senden; 4K-Aufgaben können nach einem Client-Timeout noch in_progress sein

    WaitTime=min⁡(MaxWait,BaseInterval×2attempt)+Uniform(0,1)\text{WaitTime} = \min(\text{MaxWait}, \text{BaseInterval} \times 2^{\text{attempt}}) + \text{Uniform}(0, 1)WaitTime=min(MaxWait,BaseInterval×2attempt)+Uniform(0,1)


    5. Preise und FinOps-ROI

    Gescha¨tzte Kosten=erfolgreiche abrechenbare Bilder×aktueller Kontotarif fu¨r dieses Modell, diese Gro¨ße und Auflo¨sung\text{Geschätzte Kosten} = \text{erfolgreiche abrechenbare Bilder} \times \text{aktueller Kontotarif für dieses Modell, diese Größe und Auflösung}Gescha¨tzte Kosten=erfolgreiche abrechenbare Bilder×aktueller Kontotarif fu¨r dieses Modell, diese Gro¨ße und Auflo¨sung

    • Verwenden Sie keine älteren Stückpreise wie $0.024 für 1024 px oder $0.072 für 2048 px. Diese Zeilen gehören zu einem veralteten Größenvertrag.
    • Der GPT Image 2 Modell-Leitfaden zeigt derzeit einen ToAPIs-Landing-Vergleich von $0.015 / $0.020 / $0.025 pro Bild bei 1K / 2K / 4K für Standard-gpt-image-2. Verwenden Sie das nur als veröffentlichten Vergleich. Bestätigen Sie den Satz, der für Ihr Konto und die exakte aufgerufene Modell-ID gilt.
    • Ein günstiger Loop besteht aus Entwürfen in 1k und anschließender Beförderung des akzeptierten Prompts (und der Referenzen) auf 4k. Zwei erfolgreiche Aufgaben sind zwei abrechenbare Bilder, sofern Ihre Kontobedingungen nichts anderes sagen. Es gibt keinen dokumentierten kostenlosen „dieselbe Prompt hochskalieren"-Abkürzung.
    • Token-Preise des offiziellen Anbieters und ToAPIs-Preise pro Anfrage sind nicht austauschbar. Wenn Sie zu gpt-image-2-vip oder einer SKU des offiziellen Kanals wechseln, lesen Sie das Preissheet dieser ID erneut.
    • Als Hintergrund lesen Sie den GPT Image 2 Preisartikel und prüfen dann jede Zahl am Live-Katalog, bevor Sie sie in eine Prognose aufnehmen.

    6. Häufig gestellte Fragen

    Siehe den FAQ-Block im Frontmatter. Zusammenfassung: 4K ist ein eigenständiger resolution-Wert, kein upscale-Flag; Pixelmaße hängen von size und resolution ab; senden Sie 1024x1024 nicht als size; bestätigen Sie 5:4 / 4:5 in 4k an der Live-API, wenn Sie diese Verhältnisse brauchen; bestätigen Sie die gelisteten 1K / 2K / 4K-Sätze in Ihrem Konto.


    7. Aktions-Checkliste

    • Erstellen Sie einen Schlüssel im ToAPIs Developer Portal.
    • Legen Sie eine Basis-URL pro Umgebung fest (https://api.toapis.com oder, wo erforderlich, https://toapis.cn) und testen Sie das cURL-Snippet mit size: "16:9" und resolution: "1k".
    • Befördern Sie denselben Prompt auf resolution: "4k" und bestätigen Sie die dokumentierte Pixelgröße für dieses Verhältnis (für 16:9 also 3840x2160).
    • Speichern Sie die Task-id, geben Sie 4K-Abfragen eine längere Frist und beachten Sie Retry-After bei 429.
    • Als Nächstes: der Inpainting- und Outpainting-Leitfaden, wenn Sie einen bestehenden Frame bearbeiten, und der API-Leitfaden für die umfassendere Parameterliste.

    In diesem Beitrag erwähnte Modelle entdecken

    OpenAIIMAGE

    GPT-Image-2

    Aktueller Preis: 3 credits /request
    Modell-LeitfadenIn der Konsole testenAPI-Schlüssel erhalten
    OpenAIIMAGE

    GPT-Image-2 VIP

    Aktueller Preis: 3.38 credits /request
    Modell-LeitfadenIn der Konsole testenAPI-Schlüssel erhalten

    Verwandte Artikel

    tutorial2026-11-12T10:00:00+08:006 Min. Lesezeit

    Inpainting und Outpainting mit der GPT Image 2 Bildbearbeitungs-API meistern

    Bearbeiten Sie bestehende Bilder mit dem aktuellen GPT Image 2-Vertrag: referenzgeführte Änderungen auf gpt-image-2 und maskenbasiertes Inpainting auf gpt-image-2-official — alles auf dem asynchronen Generierungsendpunkt.

    TO
    ToAPIs Engineering & Evaluation Team
    #GPT Image 2
    tutorial2026-11-11T10:00:00+08:006 Min. Lesezeit

    GPT Image 2 globaler Mirror und Proxy: latenzarmer Zugang für internationale Teams

    Wie internationale Teams die GPT Image 2 API über einen dokumentierten ToAPIs-Origin aufrufen, Sitzungen wiederverwenden und asynchrone Bildaufgaben abfragen können, ohne sich auf ungeprüfte Latenzzahlen zu verlassen.

    TO
    ToAPIs Engineering & Evaluation Team
    #GPT Image 2
    tutorial2026-10-23T10:00:00+08:003 Min. Lesezeit

    GPT Image 2 API: vollständiger Leitfaden zu Parametern, offiziellen Spezifikationen und Python-Beispielen

    Integrationsleitfaden für Entwickler zur GPT Image 2 API. Sie lernen Parameter-Tuning, HD-Auflösungen, die Steuerung des Seitenverhältnisses, Inpainting und die Umsetzung in Python und Node.js.

    TO
    ToAPIs Engineering & Evaluation Team
    #GPT Image 2
    ToAPIs
    StartseiteToAPIs
    Unternehmens-KI-API-Gateway. Greife über eine einheitliche API auf GPT-5, Claude, Gemini und über 200 Modelle zu.

    Beliebte Modelle

    • Seedance 2.5 API
    • Seedance 2.0 API
    • Veo 3.1 Fast API
    • Kling 3.0 Turbo API
    Mehr anzeigenWeniger anzeigen
    • GPT Image 2 API
    • Claude Opus 4.8 API
    • Nano Banana 2 API
    • Seedance 2 Mini API
    • Alle Modelle

    API-Kategorien

    • KI-Bild-API
    • KI-Video-API
    • Text-zu-Video-API
    • Bild-zu-Video-API
    Mehr anzeigenWeniger anzeigen
    • KI-Bildbearbeitungs-API
    • LLM- und Reasoning-API
    • Alle API-Tools →

    Alternativen

    Alternativen
    • Kie.ai-Alternative
    • Fal.ai-Alternative
    • OpenRouter-Alternative
    • Replicate-Alternative
    • Wavespeed-AI-Alternative
    • Alle Vergleiche →

    Empfohlene Leitfäden

    Empfohlene Leitfäden
    • Preise von Seedance 2.0 und 2.5
    • Leitfaden zur günstigsten Seedance-API
    • Integrationsleitfaden zu MiniMax H3
    • Kostenloser Seedance-2-API-Schlüssel
    • Schnellstart der Seedance-2-API
    • Alle Engineering-Beiträge →

    Entwickler und Plattform

    Entwickler und Plattform
    • API-Dokumentation
    • MCP
    • Preise
    • Modell-Playground
    • LLMs.txt
    • Support kontaktieren
    • Verzeichnis der Modell-Leitfäden
    Betreiber:
    鯨樞智能科技有限公司
    JINGSHU INTELLIGENT LIMITED
    Sitz der Gesellschaft:
    ROOM 5042, 5/F, YAU LEE CENTRE, NO.45, HOI YUEN ROAD, KWUN TONG, KOWLOON, HONG KONG
    DatenschutzNutzungsbedingungenZulässige NutzungDatenlöschungDatenaufbewahrungAuftragsverarbeiter und RegionenAbrechnung und ErstattungenCookie-RichtlinieSitemapÜber uns

    © 2026 ToAPIs. Alle Rechte vorbehalten.