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 Parameter des Modellanbieters (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 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