promptstringObligatorioPara el objeto descrito: Descripción obligatoria de hasta 1,024 caracteres: objeto entero, forma, material, color, estilo y escala.
- Valor predeterminado
- Sin especificar
- Restricciones
- minLength:1maxLength:1024
tripo/h3.1/text-to-3dTripo H3.1 Text to 3D transforma una descripción en un objeto 3D, normalmente un GLB con texturas. Primero crea una imagen de referencia y luego construye la malla. `image_seed` corresponde a esa primera imagen; geometría y texturas tienen sus propias semillas.
Los ejemplos usan las definiciones públicas de parámetros del endpoint seleccionado. Sustituye la clave de API y los medios de ejemplo, y envía la solicitud desde tu servidor.
SDK e integracioneshttps://api.spicyapi.ai/api/v1/jobs/createTaskGuarda la clave de API en la variable de entorno del servidor SPICY_API_KEY. Usa autenticación Bearer y Content-Type: application/json en las solicitudes JSON.
Authorization: Bearer $SPICY_API_KEY# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "tripo/h3.1/text-to-3d",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"low_poly": false,
"quad_mesh": false,
"generate_pbr": true,
"generate_parts": false,
"texture_quality": "standard"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"Generado a partir del esquema de entrada de este modelo: el mismo con el que la API valida cada solicitud.
Incluye estos campos en el objeto input del cuerpo de la solicitud. Los nombres y tipos coinciden con la API. No supongas un valor predeterminado si no está indicado.
promptstringObligatorioPara el objeto descrito: Descripción obligatoria de hasta 1,024 caracteres: objeto entero, forma, material, color, estilo y escala.
texture_seedintegerOpcionalPara el objeto descrito: Semilla de texturas para comparar superficies sin garantizar salidas idénticas.
image_seedintegerOpcionalPara el objeto descrito: Semilla de la imagen de referencia previa al 3D, para comparar sin prometer repetición exacta.
seedintegerOpcionalPara el objeto descrito: Semilla geométrica para comparar un cambio por vez, sin garantía de repetición exacta.
uv_unwrapbooleanOpcionalPara el objeto descrito: Activo por defecto; apagar la exportación UV reduce tiempo y tamaño, pero elimina las coordenadas para texturizar después.
auto_sizebooleanOpcionalPara el objeto descrito: Apagado por defecto; estima dimensiones reales y requiere salida con texturas.
face_limitintegerOpcionalPara el objeto descrito: Objetivo de 1,000 a 2,000,000 caras para el objeto descrito; con low_poly, se recomienda hasta 20,000.
generate_partsbooleanOpcionalAfecta al precioPara el objeto descrito: Separa piezas triangulares sin textura; ignora las opciones de textura y quads y reemplaza esos adicionales por el de separación.
low_polybooleanOpcionalAfecta al precioPara el objeto descrito: Procesamiento low-poly de aspecto artesanal con adicional propio; se recomienda face_limit de hasta 20,000.
quad_meshbooleanOpcionalAfecta al precioPara el objeto descrito: Produce topología de cuadriláteros en FBX en lugar de GLB; con generate_parts se ignora y no se cobra.
geometry_qualitystringOpcionalAfecta al precioPara el objeto descrito: standard o detailed; detailed agrega detalle geométrico y su propio costo.
"standard""detailed"remove_lightingbooleanOpcionalPara el objeto descrito: Activo por defecto, solo funciona con v3.5; elimina la iluminación incorporada en la referencia.
texture_versionstringOpcionalPara el objeto descrito: Elige v3.0-20250812 por defecto o v3.5-20260815; fast y la eliminación de iluminación usan v3.5.
"v3.0-20250812""v3.5-20260815"texture_qualitystringOpcionalAfecta al precioPara el objeto descrito: standard es el valor predeterminado; detailed y extreme (8K) agregan costo; fast usa v3.5 al precio de standard; sin texturas no se cobra calidad.
"standard""detailed""extreme""fast"generate_pbrbooleanOpcionalAfecta al precioPara el objeto descrito: Activo por defecto; los materiales PBR habilitan texturas aunque generate_texture esté apagado.
generate_texturebooleanOpcionalAfecta al precioPara el objeto descrito: Activo por defecto; para quitar la textura de color también debes desactivar generate_pbr.
negative_promptstringOpcionalPara el objeto descrito: Exclusiones breves de hasta 255 caracteres, por ejemplo base o pedestal.
{
"type": "object",
"required": [
"prompt"
],
"x-pricing": {
"billingMode": "formula",
"variantFields": []
},
"properties": {
"seed": {
"type": "integer",
"x-ui": {
"order": 20,
"widget": "number",
"advanced": true
},
"maximum": 2147483647,
"minimum": 0,
"description": "Seed for the geometry step, for reproducible shapes."
},
"prompt": {
"type": "string",
"x-ui": {
"order": 100,
"widget": "textarea",
"primary": true
},
"maxLength": 1024,
"minLength": 1,
"description": "Describe the object to build: shape, material, colour, style and scale. One object, fully visible. Up to 1,024 characters."
},
"low_poly": {
"type": "boolean",
"x-ui": {
"order": 68,
"widget": "switch",
"affects_price": true
},
"default": false,
"description": "Build a low-poly mesh with clean, hand-modelled-style topology instead of a dense scan-like one. Best for simple objects; keep face_limit at 20,000 or below with it. Off by default; adds to the price."
},
"auto_size": {
"type": "boolean",
"x-ui": {
"order": 30,
"widget": "switch",
"advanced": true,
"affects_price": false
},
"default": false,
"description": "Scale the mesh to estimated real-world dimensions. Off by default."
},
"quad_mesh": {
"type": "boolean",
"x-ui": {
"order": 70,
"widget": "switch",
"affects_price": true
},
"default": false,
"description": "Return four-sided (quad) polygons instead of triangles, for editing in modelling tools; the file then comes back as FBX instead of GLB. Off by default; adds to the price. Ignored when generate_parts is on."
},
"uv_unwrap": {
"type": "boolean",
"x-ui": {
"order": 25,
"widget": "switch",
"advanced": true,
"affects_price": false
},
"default": true,
"description": "Unwrap UV coordinates during generation. On by default; turning it off is faster and gives a smaller file, but the mesh then has no UVs for texturing later. Does not change the price."
},
"face_limit": {
"type": "integer",
"x-ui": {
"step": 1000,
"order": 65,
"widget": "slider",
"affects_price": false
},
"maximum": 2000000,
"minimum": 1000,
"description": "Target face count, 1,000 to 2,000,000. Leave empty to let the model decide (often over a million faces). Does not change the price."
},
"image_seed": {
"type": "integer",
"x-ui": {
"order": 15,
"widget": "number",
"advanced": true
},
"maximum": 2147483647,
"minimum": 0,
"description": "Seed for the first step, which draws a reference picture from the prompt. Keep it fixed to keep the same starting picture."
},
"generate_pbr": {
"type": "boolean",
"x-ui": {
"order": 85,
"widget": "switch",
"affects_price": true
},
"default": true,
"description": "Add PBR material maps (metal-roughness and normal). On by default and switches texturing on."
},
"texture_seed": {
"type": "integer",
"x-ui": {
"order": 10,
"widget": "number",
"advanced": true
},
"maximum": 2147483647,
"minimum": 0,
"description": "Seed for the texture step. Keep seed fixed and change this to try new textures on the same shape."
},
"generate_parts": {
"type": "boolean",
"x-ui": {
"order": 67,
"widget": "switch",
"affects_price": true
},
"default": false,
"description": "Return the model split into separate, editable parts. Parts are untextured triangle meshes, so the texture options and quad_mesh are ignored and not charged. Off by default; costs more than the textured default."
},
"negative_prompt": {
"type": "string",
"x-ui": {
"order": 96,
"widget": "textarea",
"advanced": true
},
"maxLength": 255,
"description": "What the object should not have, written as a short list. Up to 255 characters."
},
"remove_lighting": {
"type": "boolean",
"x-ui": {
"order": 77,
"widget": "switch",
"affects_price": false
},
"default": true,
"description": "Remove the lighting and shadows baked into the picture before texturing, so the texture reacts cleanly to scene lights. On by default; only takes effect with the v3.5 texture model. Does not change the price."
},
"texture_quality": {
"enum": [
"standard",
"detailed",
"extreme",
"fast"
],
"type": "string",
"x-ui": {
"order": 80,
"widget": "radio",
"enum_labels": {
"fast": "Fast",
"extreme": "8K",
"detailed": "Detailed",
"standard": "Standard"
},
"affects_price": true
},
"default": "standard",
"description": "Texture quality: standard (the default), detailed (higher resolution), extreme (8K) or fast (standard size, generated quicker with the v3.5 texture model). detailed and extreme cost more and only apply to textured meshes."
},
"texture_version": {
"enum": [
"v3.0-20250812",
"v3.5-20260815"
],
"type": "string",
"x-ui": {
"order": 78,
"widget": "radio",
"enum_labels": {
"v3.0-20250812": "v3.0",
"v3.5-20260815": "v3.5"
},
"affects_price": false
},
"default": "v3.0-20250812",
"description": "Texture model version: v3.0-20250812 (the default) or the newer v3.5-20260815. texture_quality fast and remove_lighting use v3.5. Does not change the price."
},
"generate_texture": {
"type": "boolean",
"x-ui": {
"order": 90,
"widget": "switch",
"affects_price": true
},
"default": true,
"description": "Paint a texture onto the mesh. On by default; turning it off only removes texturing if generate_pbr is off too."
},
"geometry_quality": {
"enum": [
"standard",
"detailed"
],
"type": "string",
"x-ui": {
"order": 75,
"widget": "radio",
"enum_labels": {
"detailed": "Detailed",
"standard": "Standard"
},
"affects_price": true
},
"default": "standard",
"description": "Geometry detail: standard (the default) or detailed. detailed builds finer surface detail and costs more."
}
},
"additionalProperties": false
}HTTP 202 significa que la tarea se aceptó, no que haya terminado. Guarda el taskId devuelto y consulta esa tarea. No crees otra mientras esperas el resultado.
HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3
{
"code": 200,
"msg": "success",
"request_id": "req_example_create",
"data": {
"taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
"state": "queued",
"estimatedCost": "0.750000"
}
}La respuesta de aceptación incluye la estimación para que tu aplicación pueda mostrar el mismo importe en el historial de tareas y en la facturación.
curl --get "https://api.spicyapi.ai/api/v1/jobs/recordInfo" \
--data-urlencode "taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"Empieza consultando cada 2 segundos aproximadamente y ve espaciando los intentos. Párate en un estado final. Si se cae la conexión, consulta el taskId original. Vuelve a crear la tarea solo con la clave de idempotencia y el cuerpo originales.
import { verifyWebhook } from "@spicyapi/sdk";
// express.raw keeps the bytes we signed; express.json never matches.
app.post("/hooks/spicy", express.raw({ type: "application/json" }), (req, res) => {
const { payload } = verifyWebhook({
rawBody: req.body,
timestamp: req.header("X-Webhook-Timestamp"),
signature: req.header("X-Webhook-Signature"),
payloadVersion: Number(req.header("X-Webhook-Payload-Version")),
secret: process.env.SPICY_WEBHOOK_SECRET,
});
res.status(200).end();
void handleFinishedTask(payload);
});Pasa callBackUrl al crear la tarea y recibirás el registro terminado por POST, sin un bucle de consultas de estado. Cada entrega lleva X-Webhook-Timestamp, X-Webhook-Signature y X-Webhook-Payload-Version. La firma es un HMAC-SHA256 en base64 sobre taskId.timestamp.sha256(body), así que debes verificarla con los bytes originales: si analizas el JSON y vuelves a serializarlo, los bytes cambian y la verificación falla. Las entregas fallidas se reintentan, de modo que el mismo taskId puede llegar dos veces; haz que tu manejador sea idempotente. Responde 2xx primero y haz el trabajo después: un manejador lento se trata como una entrega fallida.
Procesa output solo cuando state sea succeeded. Si falla, consulta errorCode, errorMessage y request_id. Los costos y estados de ejemplo no representan una factura real.
{
"code": 200,
"msg": "success",
"request_id": "req_example_record",
"data": {
"taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
"model": "tripo/h3.1/text-to-3d",
"state": "succeeded",
"output": {
"assets": [
{
"key": "tasks/2026/08/28/job_01k3m8x9q2z4v7n5p6r8s0t1w3/3f7a1c9e5b2d48f0a6c1e3d5b7f9a1c3.png",
"mime": "image/png",
"url": "https://example.r2.cloudflarestorage.com/results/job_01k3m8x9q2z4v7n5p6r8s0t1w3/result.png?X-Amz-Signature=SIGNATURE_FROM_RESPONSE",
"expiresAt": "2026-08-28T12:20:08.000Z"
}
]
},
"cost": "0.750000",
"settled": true,
"createdAt": "2026-08-28T12:00:00Z",
"completedAt": "2026-08-28T12:00:30Z"
}
}Para cada archivo disponible, abre o descarga assets[].url directamente, sin la cabecera Authorization de la API. El enlace firmado expira en expiresAt: vuelve a consultar la tarea para renovarlo mientras el archivo siga dentro del periodo de conservación. Un archivo pendiente o no disponible no trae URL. Trata los enlaces firmados como datos privados.
Usa SpicyAPI en tu app, terminal, asistente de IA o flujo visual. Elige una guía de configuración.
No hace falta que escribas nada del código anterior. Conecta el servidor MCP una vez y cualquier agente que use MCP — Claude Code, Codex, Cursor, Windsurf, VS Code, Gemini CLI, Cline, LibreChat — podrá ejecutar este modelo por su nombre. También puedes ejecutarlo desde tu terminal con un solo comando.
Use tripo/h3.1/text-to-3d to generate a portrait of a dancer under neon light, and save it to ./out/.
El agente busca el modelo en el catálogo actualizado, sube el archivo local por ti, te muestra la cotización exacta y el cargo máximo, y espera tu confirmación. No se cobra nada hasta que aceptes.
claude mcp add spicyapi -e SPICY_API_KEY=$SPICY_API_KEY \
-- npx --yes --package=@spicyapi/mcp spicyapi-mcp
npx skills add spicyapi-ai/spicy-skillLa primera línea le da las herramientas al agente; la segunda le da el Skill, las reglas para usarlas: consultar la cotización antes de cobrar, subir los archivos locales en lugar de pegar sus bytes y leer la URL del resultado en vez de adivinarla. Los demás clientes usan el mismo servidor desde su propio archivo de configuración: consulta el área de desarrolladores.
npx @spicyapi/cli tasks create --model tripo/h3.1/text-to-3d \
--input-json '{"prompt":"A ceramic teapot on a linen cloth, soft window light, muted palette","low_poly":false,"quad_mesh":false,"generate_pbr":true,"generate_parts":false,"texture_quality":"standard"}' \
--waitLa entrada usa el esquema de este endpoint, igual que los ejemplos de arriba. --wait consulta el estado hasta que la tarea termina y lo imprime; agrega --yes para omitir la confirmación en CI. Define antes SPICY_API_KEY: una misma clave sirve para la API, la CLI y el servidor MCP.
npx @spicyapi/cli tasks create --model tripo/h3.1/text-to-3d \
--input-json '{…}' --retention 1h --wait
npx @spicyapi/cli tasks get $TASK_ID # read back the retention that applied--retention solo acorta el plazo: 30m, 1h, 7d, o 0 para borrar en cuanto la tarea llega a un estado final. Se aplica el plazo más corto entre tu solicitud, los ajustes de tu cuenta y el máximo de la plataforma. Consúltalo en el registro de la tarea en vez de asumir que se aplicó el plazo que pediste. Pedir más tiempo del que permite tu cuenta no tiene efecto.
Instala los nodos de SpicyAPI desde ComfyUI Manager o con el comando de abajo y busca Tripo H3.1 · Text to 3D en el lienzo. El nodo tiene las mismas opciones que esta página y muestra su precio antes de ejecutarse.
cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapiEl panel incrustado lee el mismo esquema que esta página, así que no puede desincronizarse de la API. Si tu documentación necesita contenido indexable, toma el JSON de /api/embed/models/ y renderízalo tú mismo.
<iframe src="https://spicyapi.ai/embed/es/models/tripo-h3-1/api?model=tripo%2Fh3.1%2Ftext-to-3d" width="100%" height="560" loading="lazy" title="Ejemplo de solicitud" style="border:1px solid rgba(0,0,0,.12)"></iframe>