TokenLab
API-Schlüssel erhalten
DokumentationAPI-ReferenzIntegrationen

3D

3D-Modell-Status abrufen

Ruft den Status und das Ergebnis einer 3D-Generierungsaufgabe ab

GET
/v1/tasks/{id}

Fragen Sie diesen Endpunkt ab, um den Status Ihrer 3D-Modell-Generierungsaufgabe zu überprüfen.

Wenn die Create-Response poll_url enthält, sollten Sie zum Polling bevorzugt genau diese URL verwenden. id und task_id sollten als dieselbe asynchrone Task-ID behandelt werden.

Ein abgelaufener oder nicht verfügbarer öffentlicher Task kann 404 async_task_not_found zurückgeben. Ist die Zugehörigkeit zum aktuellen API-Schlüssel nicht feststellbar, lautet die Antwort 403 task_not_owned.

Pfadparameter

idstringpatherforderlich

Die ID der 3D-Generierungsaufgabe.

Antwort

Ergebnis-, Fehler-, Zeitstempel- und Modellfelder werden zurückgegeben, wenn sie für den Task verfügbar sind.

idstring

Aufgaben-ID.

task_idstring

Alias der asynchronen Task-ID, wenn verfügbar.

poll_urlstring

Bevorzugte Polling-URL, wenn verfügbar.

statusstring

Aufgabenstatus: pending, processing, completed oder failed.

progressinteger

Optionaler Fortschrittswert. Wird nur zurückgegeben, wenn ein echter Fortschrittswert verfügbar ist; verwenden Sie status, um den Abschluss zu erkennen.

model_urlstring

URL zum Herunterladen der 3D-Modelldatei (nach Abschluss).

glb_urlstring

URL zum Herunterladen des Modells im GLB-Format (sofern verfügbar).

fbx_urlstring

URL zum Herunterladen des Modells im FBX-Format (sofern verfügbar).

errorstring | object

Fehlermeldung (im Fehlerfall).

Anfrage

curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"

Antwort

Response (Completed)
{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "completed",
  "model_url": "https://cdn.tripo3d.ai/abc123.glb",
  "glb_url": "https://cdn.tripo3d.ai/abc123.glb",
  "fbx_url": "https://cdn.tripo3d.ai/abc123.fbx"
}

Autorisierung

BearerAuth
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Pfadparameter

id*string

Die asynchrone Task-ID, die über id / task_id zurückgegeben oder in poll_url eingebettet wird

Antwort

application/json

application/json

application/json

application/json

3D-Modell erstellen

Zurück

Task-Status abrufen

Weiter