Zum Hauptinhalt springen

Schnellstart

Die 3D-Generierung ist ein asynchroner Vorgang. Der gesamte Ablauf gliedert sich in drei Schritte:
Minimalbeispiel

Übersicht der Schnittstellen

Base URL: https://aihubmix.com Authentifizierungsmethode: Bearer Token
Anders als die Video-API besitzt die 3D-API keinen /content-Download-Endpunkt und keinen DELETE-Endpunkt: Die Ergebnisse werden direkt über die content_url in output[] der Abfrageantwort heruntergeladen.

Unterstützte Modelle

Generierungstypen (generate_type)

Detaillierte API-Beschreibung

Request-Header

3D-Generierungsaufgabe erstellen

Request-Body

Validierungsregeln der Parameter
  • prompt und input_references schließen sich gegenseitig aus (nur einer darf übergeben werden); einzig bei generate_type: "Sketch" dürfen beide gleichzeitig übergeben werden (Skizze + Textbeschreibung).
  • In jedem Eintrag von input_references muss genau einer der Parameter image_url oder image_base64 übergeben werden:
    • image_url unterstützt nur öffentliche http(s)-URLs, keine data-URLs (verwenden Sie stattdessen image_base64);
    • image_base64 darf dekodiert 6 MB nicht überschreiten.
  • hy-3d-3.1 unterstützt den Generierungstyp LowPoly nicht.
  • Die Gesamtgröße des Request-Bodys darf 10 MB nicht überschreiten.
Hinweise zur Verwendung von extra_body: Native Upstream-Parameter (z. B. polygon_type) können auf der obersten Ebene von extra_body durchgereicht werden. Die folgenden Parameter müssen als Top-Level-Felder übergeben werden; erscheinen sie in extra_body, wird 400 zurückgegeben: model, prompt, image_url, image_base64, generate_type, enable_pbr, face_count, result_format; multi_view_images (Mehransichtsbilder) wird derzeit nicht unterstützt.

Beispielantwort

Beschreibung der Statuswerte

Aufgabenstatus abfragen

Fragen Sie diese Schnittstelle ab, um zu prüfen, ob die Aufgabe abgeschlossen ist. Empfohlen wird eine Abfrage alle 10–15 Sekunden. Die Abfrage wird nicht berechnet.

Beispielantwort (Generierung abgeschlossen)

Beschreibung der Felder in output[]
content_url und preview_url sind temporäre Links und laufen nach einiger Zeit ab. Bitte laden Sie die Dateien nach Abschluss der Aufgabe zeitnah herunter und speichern Sie sie in Ihrem eigenen Speicher. Die Aufgaben-ID ist ab Erstellung 24 Stunden lang abfragbar (das Feld expires_at gibt den Abfrage-Stichtag an); nach Ablauf gibt die Abfrage einen Fehler zurück. Die temporären Links unterstützen nur GET-Anfragen; HEAD-Anfragen liefern den Status 403.

Verwendungsbeispiele

Vollständiges Aufrufbeispiel

Abrechnung

  • Abrechnung pro Aufruf: Der Preis ergibt sich aus der Kombination Modell × generate_type × PBR aktiviert × Flächenanzahl angegeben × Format angegeben; die konkreten Preise finden Sie in der Modell-Galerie.
  • Die Abrechnung erfolgt bei erfolgreicher Erstellung der Aufgabe; Statusabfrage und Download der Ergebnisse werden nicht berechnet.
  • Parameterkombinationen ohne konfigurierten Preis werden bei der Erstellung direkt mit 400 abgelehnt, es entstehen keine Kosten.

FAQ

Wie lange dauert die 3D-Generierung?

In der Regel einige Minuten, abhängig von Modell, Generierungstyp und Flächenanzahl. Empfohlen wird ein Abfrageintervall von 10–15 Sekunden für die Abfrage-Schnittstelle.
  • Die Aufgaben-ID ist ab Erstellung 24 Stunden lang abfragbar; das Feld expires_at in der Antwort gibt den Abfrage-Stichtag an.
  • content_url / preview_url sind temporäre Upstream-Links und laufen nach einiger Zeit ab. Bitte nach Abschluss der Aufgabe zeitnah herunterladen und umspeichern.

Können prompt und Referenzbild gleichzeitig übergeben werden?

Nein, beide schließen sich gegenseitig aus — die einzige Ausnahme ist generate_type: "Sketch" (Skizze-zu-3D), bei dem Skizzenbild und Textbeschreibung gemeinsam übergeben werden dürfen.

Worin unterscheiden sich die einzelnen generate_type-Typen?

Was tun, wenn eine Aufgabe fehlschlägt?

Wenn status auf failed steht, enthält das Feld error in der Antwort die Fehlerinformation:
Häufige Fehlerursachen sind: Inhaltsverstoß, nicht unterstütztes Bildformat, nicht erreichbares Referenzbild usw. Bitte anhand der Fehlerinformation anpassen und erneut versuchen.
Zuletzt aktualisiert: 2026-07-17