3D
3D-Modell erstellen
Erstellt eine Aufgabe zur Generierung eines 3D-Modells
Generieren Sie 3D-Modelle aus Text oder Bildern mit Tripo3D und anderen Anbietern. Dies ist eine asynchrone API. Die Create-Response gibt eine Task-ID zurück und kann, wenn verfügbar, auch eine bevorzugte poll_url enthalten.
Die öffentliche 3D-operation wird aus der Request-Form abgeleitet: Requests nur mit prompt werden als text-to-3d behandelt, Requests mit image oder image_url als image-to-3d. Dieser Endpoint stellt kein operation-Request-Feld bereit; senden Sie nicht den legacy-Wert 3d-generation.
Anfragekörper
Prüfen Sie vor dem Senden optionaler Felder mit GET /v1/models/{model}, welche Parameter das Modell akzeptiert. Das Beispiel sendet nur model und prompt.
tripo-h3.1Zu verwendendes Modell, zum Beispiel tripo-h3.1 oder tripo-p1.0. Fragen Sie GET /v1/models?recommended_for=3d ab, bevor Sie sich auf einen Eingabetyp oder ein Ausgabeformat verlassen.
Textbeschreibung des zu generierenden 3D-Modells.
Base64-kodiertes Bild für die Image-to-3D-Generierung.
URL des Bildes für die Image-to-3D-Generierung.
Ausgabeformat; Unterstützung und erlaubte Werte hängen vom gewählten Modell ab.
Qualitätseinstellung; Unterstützung und erlaubte Werte hängen vom gewählten Modell ab.
Stil-Voreinstellung für das Modell.
Ganzzahliger Seed, sofern das gewählte Modell ihn unterstützt.
Eine eindeutige Kennung für den Endbenutzer.
Antwort
Task-ID zur Statusabfrage.
Alias der asynchronen Task-ID, wenn vom Adapter zurückgegeben.
Bevorzugte Polling-URL, wenn verfügbar.
Task-Status: pending, processing, completed oder failed.
Unix-Zeitstempel der Task-Erstellung.
Anfrage
curl -X POST "https://api.tokenlab.sh/v1/3d/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "tripo-h3.1",
"prompt": "A detailed medieval castle with towers"
}'Antwort
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "pending",
"created": 1706000000,
"model": "tripo-h3.1"
}Autorisierung
BearerAuth API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.
Ort: header
Header
Zustellungsrichtlinie pro Anfrage. Überschreibt die API-Key- und Workspace-Standardeinstellungen. Versucht automatisch zuerst TokenLab Verified und kann vor der Ausgabe, der Annahme der Anfrage oder der Erstellung persistenter Ressourcen einmalig auf Official umstellen.
Zulässige Werte
- "auto"
- "verified"
- "official"
Anfragekörper
application/json
Antwort
application/json
application/json