3D
Crear modelo 3D
Crea una tarea de generación de modelos 3D
Genere modelos 3D a partir de texto o imágenes utilizando Tripo3D y otros proveedores. Esta es una API asíncrona. La respuesta de creación devuelve una identidad de tarea y, cuando está disponible, también puede incluir un poll_url preferido.
Las operaciones 3D públicas se infieren a partir de la forma de la solicitud: las solicitudes solo con prompt se resuelven como text-to-3d, y las solicitudes con image o image_url como image-to-3d. Este endpoint no expone un campo de solicitud operation; no envíes el valor legacy 3d-generation.
Cuerpo de la solicitud
Antes de enviar campos opcionales, consulte los parámetros aceptados por el modelo con GET /v1/models/{model}. El ejemplo solo envía model y prompt.
tripo-h3.1Modelo a usar, por ejemplo tripo-h3.1 o tripo-p1.0. Consulta GET /v1/models?recommended_for=3d antes de depender de un tipo de entrada o formato de salida especifico.
Descripción de texto del modelo 3D a generar.
Imagen codificada en Base64 para la generación de imagen a 3D.
URL de la imagen para la generación de imagen a 3D.
Formato de salida; la compatibilidad y los valores permitidos dependen del modelo elegido.
Ajuste de calidad; la compatibilidad y los valores permitidos dependen del modelo elegido.
Preajuste de estilo para el modelo.
Semilla entera, si el modelo elegido la admite.
Un identificador único para el usuario final.
Respuesta
ID de la tarea para consultar el estado.
Alias del identificador de tarea asíncrona cuando el adaptador lo devuelve.
URL de polling prioritaria cuando está disponible.
Estado de la tarea: pending, processing, completed o failed.
Marca de tiempo Unix de la creación de la tarea.
Solicitud
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"
}'Respuesta
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "pending",
"created": 1706000000,
"model": "tripo-h3.1"
}Autorización
BearerAuth Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.
Ubicación: header
Encabezados
Política de entrega por solicitud. Sustituye los valores predeterminados de la API key y del Workspace. Auto intenta primero con TokenLab Verified y puede cambiar una vez a Official solo antes de la salida, la aceptación de la solicitud o la creación de recursos persistentes.
Valores permitidos
- "auto"
- "verified"
- "official"
Cuerpo de la solicitud
application/json
Respuesta
application/json
application/json