Schnellstart
Die 3D-Generierung ist ein asynchroner Vorgang. Der gesamte Ablauf gliedert sich in drei Schritte:Ü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
promptundinput_referencesschließen sich gegenseitig aus (nur einer darf übergeben werden); einzig beigenerate_type: "Sketch"dürfen beide gleichzeitig übergeben werden (Skizze + Textbeschreibung).- In jedem Eintrag von
input_referencesmuss genau einer der Parameterimage_urloderimage_base64übergeben werden:image_urlunterstützt nur öffentlichehttp(s)-URLs, keine data-URLs (verwenden Sie stattdessenimage_base64);image_base64darf dekodiert 6 MB nicht überschreiten.
hy-3d-3.1unterstützt den GenerierungstypLowPolynicht.- 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
Beispielantwort (Generierung abgeschlossen)
output[]
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.Wie lange sind Ergebnislinks und Aufgabe gültig?
- Die Aufgaben-ID ist ab Erstellung 24 Stunden lang abfragbar; das Feld
expires_atin der Antwort gibt den Abfrage-Stichtag an. content_url/preview_urlsind 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?
Wennstatus auf failed steht, enthält das Feld error in der Antwort die Fehlerinformation:
Zuletzt aktualisiert: 2026-07-17