Modelos, créditos e predefinições

As ferramentas de modelos, créditos e predefinições ajudam um assistente a escolher bem uma geração e a pagar por ela. list_models retorna todos os modelos com seus recursos e preços, check_balance e credit_transactions mostram os seus créditos no Nodaro Cloud, e list_node_presets e get_node_preset encontram as configurações prontas que você pode aplicar a uma geração.

list_models

Retorna os modelos disponíveis nesta instância do Nodaro, agrupados por tipo e desenvolvedor, com uma ficha de recursos de cada modelo. Chame-a antes de uma ferramenta de geração quando o usuário não tiver escolhido um modelo.

Permissão: nenhuma, sempre visível. Créditos: grátis.

Retorna: para cada modelo, as proporções, resoluções, qualidades, durações e funcionalidades e, nas edições com créditos, o preço de cada variante. Uma lista recommendations indica os melhores modelos para usos comuns, como texto em imagens ou a imagem realista mais barata. Os modelos com dicas de prompt próprias, como o Seedance 2.0, também trazem promptTips, regras curtas para aplicar antes de uma geração de vídeo.

Cada modelo também tem uma página no catálogo de modelos, com os mesmos preços e mais detalhes.

check_balance

Retorna o seu saldo de créditos, dividido em créditos da assinatura e créditos de recarga, com o total. Também retorna o seu limite diário de gastos, a sua cota mensal, o seu nível e o fim do período de cobrança.

Permissão: credits:read. Créditos: grátis. Somente no Nodaro Cloud.

Esta ferramenta não tem parâmetros.

Retorna: o saldo e os detalhes do plano.

• Quais créditos são usados primeiro. Os créditos da assinatura são gastos primeiro e são redefinidos a cada ciclo de cobrança. Os créditos de recarga valem por 12 meses após a compra.
• Pagamento por uso. Um effectiveTier igual a payg significa que você não tem assinatura, mas comprou créditos. Você tem todos os modelos, sem marca d’água e sem limite diário.
• Contas de cobrança compartilhadas. Numa implantação em que uma única conta de cobrança paga por todos, um cliente conectado não consegue ler o saldo dessa conta. A ferramenta responde payer_balance_jwt_only.

credit_transactions

Lista as suas compras recentes: assinaturas, recargas e reembolsos. Cada linha tem type, amount_usd, credits_granted, tier, created_at e receipt_url, o link para o recibo, quando houver.

Permissão: credits:read. Créditos: grátis. Somente no Nodaro Cloud.

Retorna: as linhas de compras. Os créditos gastos em cada geração não estão nesta lista: cada job traz os próprios credits, e a API REST lista os gastos com GET /v1/credits/transactions.

list_node_presets

Lista as predefinições de um tipo de nó: as integradas, como Painel de personagem ou Retrato cinematográfico, e as que você salvou. Uma predefinição é uma configuração nomeada de um nó, com o modelo, o prompt e as configurações dele.

Permissão: presets:read. Créditos: grátis.

Retorna: o nome, o ID e a descrição de cada predefinição.

get_node_preset

Retorna a configuração completa de uma predefinição: o modelo, o prompt, a proporção, a resolução, a qualidade, o prompt negativo e o texto que ela adiciona antes e depois do prompt. Use-a para aplicar uma predefinição com exatidão, copiando os campos para uma ferramenta de geração ou passando o ID dela como presetId.

Permissão: presets:read. Créditos: grátis.

Retorna: a configuração da predefinição, ou um erro quando o ID não corresponde a nenhuma predefinição.

Aplicar uma predefinição a uma geração

generate_image, generate_video, generate_music, generate_speech e text_to_audio aceitam presetId. O Nodaro aplica a configuração da predefinição no servidor, e cada campo que você mesmo informa a substitui. Quando a predefinição contém um prompt, você pode omitir prompt. O texto que a predefinição põe antes e depois do prompt envolve o seu próprio prompt.

Em generate_speech, uma predefinição ajusta a locução, como a velocidade, a estabilidade e o estilo, e text continua obrigatório. Leia mais sobre predefinições em Predefinições.