Usar el Marketplace

El Marketplace de Modelos es el punto de entrada único para todos los modelos disponibles de Tianshu, sus grupos, tarifas en vivo y estado de disponibilidad. Antes de configurar cualquier cliente, conviene confirmar primero aquí el nombre del modelo y el grupo.

Cómo navegar

1. Abre el Marketplace de Modelos (puedes explorarlo sin iniciar sesión).
2. A la izquierda está la lista de grupos de tokens disponibles, los mismos grupos que eliges al crear una clave.
3. Selecciona un grupo y, a la derecha, se mostrarán todas las tarjetas de modelos de ese grupo.

Cada tarjeta de modelo muestra:

• Nombre del modelo: cópialo directamente en el campo "Model" de tu cliente.
• Tarifa de descuento: por ejemplo "0.8x" o "0.2x"; cuanto menor sea la tarifa, más económico.
• Estado de disponibilidad: un punto verde significa que el modelo está disponible actualmente, junto con la latencia de la sonda más reciente.

Entender las tarifas de descuento

Cada modelo tiene una tarifa dentro de su grupo. Costo final = precio base del modelo × tarifa del grupo × uso real.

• Una tarifa < 1 es un descuento: 0.8 = 20% de descuento, 0.5 = 50% de descuento.
• Una tarifa > 1 es un recargo: 1.5 = pagas un 50% adicional.

La vista en vivo es la fuente autoritativa

Los modelos y las tarifas de mercado cambian rápido, por lo que esta documentación no enumera precios específicos. Confía siempre en las tarifas en vivo que se muestran en el Marketplace de Modelos: siempre son las más actualizadas.

Por qué conviene revisar aquí primero

Muchas personas solo recuerdan el nombre del grupo pero no saben qué modelos contiene realmente, y luego se topan con "el modelo no existe" después de configurar. Confirmar primero el grupo + nombre del modelo en el Marketplace evita la gran mayoría de los problemas de configuración.

Consultar la documentación de un modelo

Algunos modelos —los de vídeo en particular— muestran un botón Docs adicional en su tarjeta. Abre una documentación escrita para ese modelo concreto:

• Endpoints — a qué dirección llamar para crear una tarea, consultar el progreso y obtener el resultado
• Modos de generación — qué campos activan texto a vídeo, imagen a vídeo, fotograma inicial/final, etc. (lo que más se suele equivocar con los modelos de vídeo)
• Parámetros de la petición — qué significa cada uno, sus valores admitidos y su valor por defecto
• Ejemplos de petición / respuesta — JSON listo para copiar
• Ejemplos de uso — cuerpos de petición completos para los casos habituales

También puedes abrir Detalles y cambiar a la pestaña API: el contenido es el mismo.

Los modelos sin botón Docs simplemente aún no tienen documentación propia; llámalos con la API estándar.

TIP

Las direcciones que aparecen en la documentación ya son las que puedes llamar directamente: cópialas y úsalas tal cual.

Siguiente paso

Para saber qué grupo se adapta a cada escenario, consulta Grupos de Tokens.