3D
3D-Modell erstellen
Erstellt einen Task zur 3D-Modellgenerierung
Verwenden Sie GET /v1/models?recommended_for=3d, um aktuelle 3D-Modelle abzurufen.
Generieren Sie 3D-Modelle aus Text oder Bildern. Dies ist eine asynchrone API. Antworten auf Erstellungsanfragen geben eine Task-Identität zurück. Führen Sie damit ein Polling über GET /v1/tasks/{id} durch, um den Status abzufragen.
Die Operation ist text-to-3d oder image-to-3d. Sie können operation weglassen: Anfragen, die nur einen Prompt enthalten, werden zu text-to-3d aufgelöst, und Anfragen mit image oder image_url werden zu image-to-3d aufgelöst. Wenn Sie operation senden, muss sie mit den Eingaben übereinstimmen: image-to-3d erfordert ein Bild und text-to-3d akzeptiert keines. Der Legacy-Wert 3d-generation gibt 400 unsupported_operation zurück. Jedes Modell unterstützt nur bestimmte Operationen; prüfen Sie dies unter GET /v1/models/{model}.
Request-Body
Prüfen Sie vor dem Senden optionaler Felder GET /v1/models/{model} auf die vom Modell akzeptierten Parameter. Das Beispiel verwendet nur model und prompt.
tripo-h3.1Zu verwendendes Modell, zum Beispiel tripo-h3.1 oder tripo-p1.0. Rufen Sie GET /v1/models?recommended_for=3d ab, bevor Sie sich auf einen bestimmten Eingabetyp oder ein bestimmtes Ausgabeformat verlassen.
text-to-3d oder image-to-3d. Optional; wird aus den Eingaben abgeleitet, wenn nicht angegeben.
Textuelle Beschreibung des zu generierenden 3D-Modells, bis zu 2000 Zeichen. Modelle können ein kürzeres Limit festlegen; siehe deren Details. Image-to-3D-Anfragen benötigen bei den aktuellen Modellen ebenfalls einen prompt; ohne diesen gibt die Anfrage 400 prompt is required zurück.
Base64-codiertes Bild für die Image-to-3D-Generierung.
Öffentliche URL eines Bildes für die Image-to-3D-Generierung.
Ausgabeformat; Unterstützung und zulässige Werte hängen vom ausgewählten Modell ab.
Qualitätseinstellung; Unterstützung und zulässige Werte hängen vom ausgewählten Modell ab.
Stil-Voreinstellung für das Modell.
Ganzzahliger Seed, sofern vom ausgewählten Modell unterstützt.
Eine eindeutige Kennung für den Endbenutzer. Senden Sie diese nur, wenn das ausgewählte Modell sie akzeptiert.
Einige Modelle führen auch n, negative_prompt und output_format (ein Alias für format) auf. Senden Sie diese nur, wenn sie in den Details des Modells aufgeführt sind.
Antwort
Task-ID für das Status-Polling.
Alias der asynchronen Task-Kennung, wenn vom Adapter zurückgegeben.
Status-URL für diesen Task. Führen Sie ein Polling für GET /v1/tasks/{id} mit id durch.
Task-Status: pending, processing, completed oder failed.
Unix-Timestamp 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"
Optionaler Schlüssel, der eine Erstellungsanfrage sicher für Wiederholungsversuche macht. Senden Sie für jede Aufgabe einen neuen eindeutigen Wert, wie z. B. eine UUID. Ein Wiederholungsversuch mit demselben Schlüssel und demselben Body gibt das Ergebnis der ursprünglichen Erstellungsanfrage zurück, in der Regel die ursprüngliche Aufgabe, und erstellt, versendet oder berechnet keine zweite Aufgabe. Ein abweichender Body mit einem bereits akzeptierten Schlüssel wird mit 409 abgelehnt. Ein Schlüssel mit mehr als 255 Zeichen wird ignoriert, und die Anfrage verfügt dann über keinen Idempotenz-Schutz. Siehe Sichere Wiederholungsversuche mit einem Idempotenz-Schlüssel.
1 <= length <= 255Anfragekörper
application/json
Antwort
application/json
application/json
application/json
application/json
application/json
application/json