# Modelos y Versiones

## Modelos de generación 3D

El parámetro `model` utilizado por puntos finales de generación 3D como `POST /v3/generation/text-to-model` y `POST /v3/generation/image-to-model`.

| Modelo ID | Descripción | Caso de uso recomendado |
| :-: | :-: | :-: |
| `tripo-p1` | Mejor rendimiento de baja poli | Canalizaciones de juegos / Jugabilidad generativa UGC / Recursos móviles 3D |
| `tripo-v3.1` | Último modelo de alta precisión (predeterminado) | Tuberías de producción AAA / Impresión 3D y fabricación flexible |
| `tripo-v3.0` | Versión estable de generación anterior | Compatibilidad con versiones anteriores |
| `tripo-v2.5` | Versión heredada | Compatibilidad histórica del proyecto |

## Modelos de generación de imágenes

El parámetro `model` utilizado por los puntos finales `POST /v3/generation/text-to-image` y `POST /v3/generation/image-to-image`.

| Modelo ID | Proveedor | Características |
| :-: | :-: | :-: |
| `seedream_v4` | ByteDanza | Modelo predeterminado con resultados equilibrados |
| `seedream_v5` | ByteDanza | Última versión con calidad mejorada. |
| `gemini-2.5-flash` | google | Generacion rapida |
| `gemini-3-pro` | google | Generación de alta calidad |
| `gemini-3.1-flash` | google | Última versión rápida |
| `chat_image_1` | AbiertoAI | Generación de imágenes GPT |
| `chat_image_1.5` | AbiertoAI | GPT mayor calidad |
| `chat_image_2` | AbiertoAI | GPT último |

## Recomendaciones para la selección de versiones

- **Nuevos proyectos**: utilice las versiones predeterminadas, `tripo-v3.1` para 3D y `seedream_v4` para imágenes, para obtener el mejor equilibrio entre calidad y estabilidad.
- **Entornos de producción**: fije una versión de modelo específica para evitar inconsistencias en la salida causadas por las actualizaciones del modelo.
- **Máxima calidad**: utilice `tripo-p1` para 3D y elija `gemini-3-pro` o `seedream_v5` para imágenes según el escenario.
- **Activos de juego/Low-poly**: use `tripo-p1` para 3D: topología más limpia y control de recuento de caras más preciso

## Ejemplos de solicitudes

```bash
# Use the default model
curl -X POST https://openapi.tripo3d.com/v3/generation/text-to-model \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{"prompt": "a robot"}'

# Specify the flagship model
curl -X POST https://openapi.tripo3d.com/v3/generation/text-to-model \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{"prompt": "a robot", "model": "tripo-p1"}'

# Use an image generation model
curl -X POST https://openapi.tripo3d.com/v3/generation/text-to-image \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{"prompt": "a futuristic city", "model": "seedream-v5"}'
```
