aisplice

API-Referenz

3D-Modelle

Modelle für diesen Endpunkt (1)

tripo-3d
In der Workbench ausprobieren
POST/v1/model3d/tasks
GET/v1/model3d/tasks/{task_id}

Asynchrone 3D-Generierung und Nachbearbeitung. Ein Feld, operation, bestimmt, was der Task tut: ein Modell aus Text, einem Bild oder mehreren Ansichten erstellen und es dann texturieren, segmentieren, retopologisieren oder riggen. Das Einreichen gibt eine task_id zurück; fragen Sie sie ab, bis die Modell-URL im Task-Body erscheint.

#Anfrageparameter

  • modelstringerforderlich

    Eine 3D-Modell-ID aus dem Katalog, z. B. tripo-3d.

  • operationstringerforderlich

    text_to_model · image_to_model · multiview_to_model · texture · smart_segment · retopology · rig · animate.

  • promptstringoptional

    Was erstellt werden soll. Wird von text_to_model verwendet.

  • inputstringoptional

    Eine öffentliche Bild-URL für image_to_model oder die task_id eines fertigen 3D-Modells für texture, smart_segment, retopology, rig und animate.

  • inputsobject[]optional

    multiview_to_model: [{"front": url}, {"left": url}, …] — eine Frontansicht plus mindestens eine weitere.

  • texturebooleanoptional

    Texturen zusammen mit dem Modell generieren.

  • pbrbooleanoptional

    PBR-Materialien generieren.

  • texture_promptobjectoptional

    texture: {"text": "weathered bronze"} beschreibt die neue Oberfläche.

  • face_limitintegeroptional

    retopology: die maximale Anzahl an Flächen im Ergebnis.

  • quadbooleanoptional

    retopology: Quad-Mesh statt Dreiecken.

  • animationstringoptional

    animate: die Animation, die auf ein geriggtes Modell angewendet wird.

#Zugehörige Fehler

  • 404 not_foundUnbekannte task_id, oder der Eingabe-Task eines Folgeschritts existiert nicht oder ist nicht abgeschlossen.
  • 401Ungültiges oder fehlendes Bearer-Token. Auf diesem Pfad gibt es kein error.code — werten Sie den Status aus.
  • 402 insufficient_user_quotaDas Wallet-Guthaben deckt die vorab reservierte Schätzung nicht.
  • 429Drosselung pro Schlüssel. Leerer Body; warten Sie Retry-After ab. Ein 429, das insufficient_user_quota enthält, ist dagegen ein tägliches Ausgabenlimit.
  • 503 model_not_foundUnbekanntes Modell, oder derzeit bedient es kein funktionsfähiger Kanal.

Vollständige Fehlercode-Tabelle →

#Beispielanfrage

# 1. make a model from text
curl https://www.aisplice.store/v1/model3d/tasks \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "tripo-3d", "operation": "text_to_model", "prompt": "A small ceramic fox", "texture": true}'

# 2. poll until status is completed; the file is in url
curl https://www.aisplice.store/v1/model3d/tasks/$TASK_ID -H "Authorization: Bearer sk-YOUR_KEY"

# 3. texture it: pass the finished task_id as input
curl https://www.aisplice.store/v1/model3d/tasks \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "tripo-3d", "operation": "texture", "input": "'$TASK_ID'", "texture_prompt": {"text": "weathered bronze"}}'

#Antwort

response.json
// POST /v1/model3d/tasks
{"task_id": "task_xxx", "status": "queued"}

// GET /v1/model3d/tasks/{task_id} — after completion
{"task_id": "task_xxx", "status": "completed", "url": "https://…/model.glb", "output": {"model_url": "https://…/model.glb"}}

Immer noch nicht gelöst?

Senden Sie uns die Anfrage-ID oder die Fehlermeldung, und wir sehen uns das an.

ZurückMusikWeiterDatei-Upload-Policy