Usando o Marketplace

O Marketplace de Modelos é o ponto de entrada único para todos os modelos disponíveis na Tianshu, seus grupos, taxas em tempo real e status de disponibilidade. Antes de configurar qualquer cliente, é uma boa ideia confirmar aqui o nome do modelo e o grupo.

Como navegar

1. Abra o Marketplace de Modelos (acessível sem fazer login).
2. À esquerda fica a lista de grupos de token disponíveis — os mesmos grupos que você escolhe ao criar uma chave.
3. Selecione um grupo e o lado direito listará todos os cards de modelo daquele grupo.

Cada card de modelo mostra:

• Nome do modelo: copie-o diretamente para o campo "Model" do seu cliente.
• Taxa de desconto: por exemplo "0.8x" ou "0.2x" — quanto menor a taxa, mais barato.
• Status de disponibilidade: um ponto verde indica que o modelo está disponível no momento, junto com a latência da sondagem mais recente.

Entendendo as taxas de desconto

Cada modelo tem uma taxa dentro do seu grupo. Custo final = preço base do modelo × taxa do grupo × uso real.

• Uma taxa < 1 é um desconto: 0.8 = 20% de desconto, 0.5 = 50% de desconto.
• Uma taxa > 1 é um acréscimo: 1.5 = pagar 50% a mais.

A visão em tempo real é a fonte oficial

Os modelos e as taxas de mercado mudam rápido, por isso esta documentação não lista preços específicos. Confie sempre nas taxas em tempo real exibidas no Marketplace de Modelos — elas estão sempre mais atualizadas.

Por que verificar aqui primeiro

Muita gente lembra apenas do nome do grupo, mas não sabe quais modelos o grupo de fato contém, e acaba esbarrando em "o modelo não existe" depois de configurar. Confirmar o grupo + nome do modelo no Marketplace primeiro evita a grande maioria dos problemas de configuração.

Ver a documentação de um modelo

Alguns modelos — os de vídeo em especial — exibem um botão Docs extra no cartão. Ele abre uma documentação escrita para aquele modelo:

• Endpoints — qual endereço chamar para criar a tarefa, consultar o progresso e obter o resultado
• Modos de geração — quais campos acionam texto-para-vídeo, imagem-para-vídeo, primeiro/último quadro etc. (o erro mais comum com modelos de vídeo)
• Parâmetros da requisição — o significado de cada um, valores aceitos e valor padrão
• Exemplos de requisição / resposta — JSON pronto para copiar
• Exemplos de uso — corpos de requisição completos para os casos comuns

Você também pode abrir Detalhes e ir até a aba API: o conteúdo é o mesmo.

Modelos sem o botão Docs apenas ainda não têm documentação dedicada; chame-os pela API padrão.

TIP

Os endereços mostrados na documentação já são os que você pode chamar diretamente — copie e use.

Próximo passo

Para saber qual grupo se encaixa em cada cenário, consulte Grupos de Token.