Auto-Rig
LiveFüg einem humanoiden Modell ein Skelett hinzu, damit es sich bewegen kann. Du bekommst geriggtes FBX und GLB, dazu Geh- und Laufclips.
Auto-Rig
Eingabe
model_urlEin öffentlicher https-Link zum GLB, das geriggt werden soll, oder zu einem FBX aus unserem 3D-Modell-Tool.animationsAnimationsclips für das geriggte Modell.Ohne AufpreisSo funktioniert die 3D-Pipeline
Dieselben Schritte, mit denen wir Figuren für unsere eigenen Spiele bauen.
- 01T-Pose-PrüfungEin kurzer Blick auf dein Bild. Ist es keine strenge frontale T-Pose mit geschlossenem, neutralem Mund vor schlichtem Hintergrund, wird es so neu gezeichnet, mit derselben Figur. Ausgestreckte Arme halten die Hände sauber.
- 023D-ModellEin texturiertes, spielfertiges Mesh aus dem T-Pose-Bild, mit PBR-Materialien und ohne eingebackenes Licht. Figuren und Requisiten haben eigene Dreiecksbudgets.
- 03RigEin an die Figur angepasstes Skelett, damit sie sich bewegen kann, auf Wunsch mit Geh- und Laufclips. Du bekommst FBX für Spiele-Engines und GLB fürs Web.
Alle drei Schritte in einem Aufruf:3D-Figuren
Auto-Rig aus deinem Code aufrufen
Jedes 3D-Tool ist ein eigener Endpunkt. Jeder Aufruf liefert eine Aufgabe: Frag sie ab, bis sie fertig ist. Ein fehlgeschlagener Lauf wird nicht berechnet.
https:/ / api.opennan.com/ v1/ 3d/ rig- POST
/Bild oder Prompt zu einer geriggten Figur.v1/ 3d/ characters - POST
/Jedes Figurenbild zu einer frontalen T-Pose.v1/ 3d/ tpose - POST
/Bild oder Prompt zu einem texturierten Modell.v1/ 3d/ models - GET
/Fortschritt und Ausgabedateien.v1/ tasks/ {id} - GET
/3D-Engines und Qualitätsstufen, mit Preisenv1/ models? category= 3d
API-Schlüssel holen
Erstelle einen Schlüssel in der Konsole. Er nutzt dasselbe Guthaben wie der Playground.
Schlüssel erstellenErste Anfrage senden
Dieselbe Anfrage, die der Playground sendet. Setze OPENNAN_KEY auf deinen Schlüssel.
curl https://api.opennan.com/v1/3d/rig \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"model_url":"https://example.com/character.glb","animations":true}' # Then poll until "status" is "succeeded" or "failed": curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"Task abfragen
Der Aufruf antwortet sofort mit einer Task-ID. Frag den Task ab, bis er fertig ist:
GEThttps:// api.opennan.com/ v1/ tasks/ {id} - queued
- Wartet auf einen Worker
- running
- Wird erstellt
- succeeded
- Fertig: outputs[].url enthält die Dateien
- failed
- Fehlgeschlagen: wird nicht berechnet
Fehler und wie du sie behebst
401Schlüssel fehlt oder ist falsch
Sende den Header Authorization: Bearer mit einem Schlüssel aus der Konsole.
402Guthaben zu niedrig
Lade unter Abrechnung Guthaben auf und sende denselben Aufruf erneut.
400Ein Wert wird nicht akzeptiert
Lies error.message: Dort steht das Feld. Nimm einen Wert aus der Parametertabelle.
429Zu viele Anfragen
Warte ein paar Sekunden und versuche es erneut, nach jedem 429 etwas länger.
Opennan zu deiner KI-App hinzufügen
Eine Installation gibt deiner KI jedes Opennan-Tool: Video, Bilder, Chat, Stimme, Musik, Soundeffekte, 3D, Untertitel und Synchronisation. Wähle deine App und folge den Schritten.
https:/ / api.opennan.com/ v1/ mcpFunktioniert in der Codex CLI, der Codex-App und der Codex-IDE-Erweiterung: Sie teilen ~/.codex/config.toml. Sieht die App oder IDE OPENNAN_KEY nicht, nimm die config.toml-Variante mit deinem Schlüssel. Codex fragt vor jedem Tool-Aufruf: Bestätige, um weiterzumachen.
API-Schlüssel holen
Erstelle einen Schlüssel in der Konsole. Er beginnt mit sk- und nutzt dasselbe Guthaben wie die Website.
Schlüssel erstellenSpeichere deinen Schlüssel als OPENNAN_KEY
# macOS / Linux (zsh shown; bash: ~/.bashrc) echo 'export OPENNAN_KEY="sk-..."' >> ~/.zshrc source ~/.zshrc # Windows (PowerShell), then open a new terminal setx OPENNAN_KEY "sk-..."Installiere das Opennan-Plugin: der Server plus ein Skill, der deiner KI beibringt, Modelle zu wählen, Preise zu bestätigen und auf Ergebnisse zu warten
codex plugin marketplace add Opennan/opennan-ai-plugin codex plugin add opennan@opennanOder füge nur den Server hinzu
codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEYOder füge das in ~/.codex/config.toml ein
[mcp_servers.opennan] url = "https://api.opennan.com/v1/mcp" http_headers = { Authorization = "Bearer sk-..." }Prüfe, ob opennan aufgelistet ist
codex mcp listStarte Codex neu und frag nach allem, was du willst
“Mach ein 5-Sekunden-Video von Regen auf einer Neonstraße, einen passenden Song und ein Posterbild.”
Ersetze sk-... durch deinen eigenen Schlüssel und halte ihn geheim: Wer ihn hat, kann dein Guthaben ausgeben. Deine App kann die Tools ohne Schlüssel auflisten; zum Erstellen brauchst du einen.
Aus einem KI-Agenten nutzen
Füge deinem Agenten den Opennan-MCP-Server hinzu und rufe dieses Tool auf.
- Tool
- rig_3d_model
- Beispielargumente
{ "model_url": "https://example.com/character.glb", "animations": true }
Auto-Rig: Fragen
Was kostet Auto-Rig?
Du zahlst pro Durchlauf, zum Preis, den du vor dem Start siehst.
Wie rufe ich es aus meinem Code auf?
Sende POST https://api.opennan.com/v1/3d/rig mit deinem API-Schlüssel. Die Antwort ist eine Task-ID: Frag https://api.opennan.com/v1/tasks/{id} ab, bis der Task fertig oder fehlgeschlagen ist.
Kann mein KI-Agent es nutzen?
Ja. Füge den MCP-Server https://api.opennan.com/v1/mcp hinzu und rufe das Tool rig_3d_model auf, oder verweise deinen Agenten auf https://api.opennan.com/llms.txt.
Was passiert, wenn ein Durchlauf fehlschlägt?
Ein fehlgeschlagener Durchlauf wird nicht berechnet. Du zahlst nur für Ergebnisse.
Warum braucht das Bild eine T-Pose?
Gerade ausgestreckte Arme halten die Hände vom Körper fern, so bekommt das Modell saubere Hände und das Rig knickt an den richtigen Gelenken. Herabhängende Arme oder eine A-Pose verschmelzen die Hände oft mit der Kleidung, und ein Lächeln wird in die Textur gemalt. Deshalb wird ein Bild ohne T-Pose zuerst neu gezeichnet, mit derselben Figur.
Welche Dateien bekomme ich?
GLB für das Web, Spiele-Engines und 3D-Apps, FBX für Roblox Studio, Unity, Unreal und Blender sowie ein Vorschaubild. Geriggte Läufe enthalten zusätzlich Geh- und Laufclips.