> ## Documentation Index
> Fetch the complete documentation index at: https://docs.venice.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Como funciona o catálogo de modelos

> Como a Venice monta o catálogo de modelos: famílias e variantes de modelos, preços normalizados para cada modalidade, níveis de privacidade, o conjunto de prompts de referência e como o desempenho e os benchmarks serão medidos.

O [catálogo de modelos](https://docs.venice.ai/pt-BR/models/overview.md) é gerado a partir de [`GET /models`](https://docs.venice.ai/pt-BR/api-reference/endpoint/models/list) a cada hora. Esta página explica como os números exibidos nele são calculados, para que você possa reproduzi-los e saber o que eles significam e o que não significam.

## Famílias e variantes

Muitos IDs de modelo são o mesmo modelo oferecido de outra forma. O catálogo os agrupa em uma única página de família:

| Tipo de variante | Exemplo | Por que é separada |
| - | - | - |
| Privacidade | `z-ai-glm-5-3` e `e2ee-glm-5-3-p` | A variante E2EE é executada em um enclave atestado e pode ter limites diferentes |
| Velocidade | `claude-opus-5-5` e `claude-opus-5-5-fast` | Atendimento mais rápido a um preço mais alto |
| Modo | `kling-v3-pro-text-to-video`, `-image-to-video`, `-motion-control` | Entradas e preços diferentes |
| Tarefa | `nano-banana-pro` e `nano-banana-pro-edit` | Endpoints de geração e de edição |

Cada variante mantém seu próprio ID de modelo, preço e nível de privacidade. Passe o ID da variante como `model`. Snapshots datados, como `deepseek-v4-flash-0731`, continuam sendo famílias separadas e aparecem em **Outras versões**.

## Preços normalizados

Cada modalidade é cobrada em sua própria unidade. O catálogo mostra a unidade nativa e um preço de referência, para que os modelos possam ser ordenados e comparados.

| Modalidade | Unidade nativa | Preço de referência |
| - | - | - |
| Texto | Por 1M de tokens de entrada e de saída | **Combinado**: `(3 × input + output) / 4`, a proporção 3:1 usada pela Artificial Analysis. O desconto de entrada em cache é `1 − cached ÷ input`. |
| Imagem | Por imagem, por nível de resolução | Preço por imagem no nível selecionado (1K, 2K ou 4K). Edições adicionam uma sobretaxa por imagem para entradas extras. |
| Vídeo | Por clipe, por resolução, duração e áudio | Preço por segundo e por clipe nas configurações selecionadas, a partir de uma matriz completa de cotações (abaixo). |
| Texto para fala | Por 1M de caracteres | Por minuto de fala a 150 palavras (cerca de 825 caracteres) por minuto. |
| Fala para texto | Por segundo de áudio | Por hora de áudio e por 1.000 minutos. |
| Música e efeitos sonoros | Por faixa, por segundo ou por faixa de duração | Por minuto de áudio quando o modelo permite; caso contrário, por faixa. |
| Embeddings | Por 1M de tokens de entrada | Sem alteração. |

> [!NOTE]
>
> Modelos de raciocínio podem gastar muito mais tokens de saída do que modelos sem raciocínio na mesma tarefa, então o preço combinado subestima o custo real deles. O custo por tarefa, medido em execuções de benchmark, está planejado; veja [Benchmarks](#benchmarks).

### Preços de vídeo

Os modelos de vídeo não publicam preços em `GET /models`. Durante o build, a Venice chama [`POST /video/quote`](https://docs.venice.ai/pt-BR/api-reference/endpoint/video/quote) para cada combinação de resolução × duração × áudio que cada modelo suporta, na primeira proporção de tela listada (a proporção de tela não altera o preço). O catálogo armazena a matriz completa e deriva:

* **Por segundo**: a mediana de `price ÷ seconds` entre as durações para uma determinada resolução e configuração de áudio. Os preços são lineares em relação à duração para quase todos os modelos.
* **Clipe de rascunho**: 5 segundos, 720p, sem áudio.
* **Clipe de produção**: 10 segundos, 1080p, com áudio.

Quando um modelo não oferece a configuração solicitada, o catálogo usa a mais próxima que ele suporta e sinaliza o preço. Os modos de edição, controle de movimento e upscale são cobrados pela duração do seu vídeo de origem, então mostram **Pela origem** em vez de um preço. Sempre chame `POST /video/quote` antes de enfileirar para obter um valor exato.

## Níveis de privacidade

| Nível | O que significa |
| - | - |
| **E2EE** | Os prompts são criptografados no seu dispositivo e descriptografados apenas dentro de um enclave de hardware atestado. Veja [Modelos TEE e E2EE](https://docs.venice.ai/pt-BR/guides/features/tee-e2ee-models.md). |
| **TEE** | A inferência é executada em um enclave de hardware com atestação criptográfica. |
| **Privado** | Servido em infraestrutura controlada pela Venice, com retenção zero de dados. |
| **Anonimizado** | Encaminhado ao laboratório de origem sem a sua identidade. O laboratório pode reter os prompts. |

Uma família lista todos os níveis oferecidos por suas variantes. Filtrar por um nível mostra a variante desse nível, com seu próprio preço.

## Conjunto de prompts de referência

Os modelos de imagem e de vídeo são renderizados com um conjunto fixo de prompts, os mesmos para todos os modelos de uma modalidade, nas configurações padrão. É isso que mantém a galeria do explorador comparável de um modelo para outro.

| Modalidade | Prompts |
| - | - |
| Imagem | Texto na imagem, fotorrealismo, seguimento de instruções, estilo de ilustração |
| Vídeo | Paisagem cinematográfica, loop contínuo, cena urbana cinematográfica |

Modelos sem renderizações mostram **Renderizações de referência pendentes**.

## Desempenho

> [!NOTE]
>
> Ainda não publicado. Esta seção descreve o que o catálogo mostrará.

A Venice medirá os modelos com sondas sintéticas, nunca com prompts de clientes, e publicará:

| Modalidade | Métricas |
| - | - |
| Texto | Disponibilidade, tempo até o primeiro token, tokens de saída por segundo, tempo até uma resposta de 500 tokens, taxa de acerto de cache, taxa de sucesso |
| Imagem | Disponibilidade, tempo de geração de uma imagem 1K (p50 e p95), taxa de sucesso |
| Vídeo | Disponibilidade, tempo de fila e tempo de geração de um clipe de 5 segundos em 720p (informados separadamente), taxa de sucesso |
| Áudio | Disponibilidade, tempo até o primeiro áudio, fator de velocidade, taxa de sucesso |
| Embeddings | Disponibilidade, latência para uma entrada de 1K tokens, taxa de sucesso |

Cada número mostrará sua janela (30 dias móveis para disponibilidade, 7 dias para latência), percentil, número de amostras e região da sonda. A disponibilidade exclui erros 4xx causados pela requisição. A taxa de acerto de cache é `cache_read ÷ (input + cache_read + cache_write)` em todo o tráfego. Modelos com poucas amostras serão marcados como **Preliminar**.

## Benchmarks

> [!NOTE]
>
> Ainda não publicado. Esta seção descreve o que o catálogo mostrará.

Os benchmarks são escolhidos para a fronteira: ainda discriminativos no topo, resistentes à contaminação e executáveis contra o modelo tal como a Venice o serve. Cada pontuação terá um único rótulo de procedência, nunca com médias entre eles:

* **Verificado pela Venice**: executado no endpoint da Venice mostrado na página.
* **Independente**: executado por terceiros, geralmente na própria API do laboratório.
* **Informado pelo laboratório**: publicado pelo criador do modelo.

Cada pontuação também mostra a versão do benchmark e do harness, o esforço de raciocínio, a data do teste e um intervalo de confiança. Pontuações com mais de 90 dias, ou substituídas por uma nova versão do benchmark, são sinalizadas como desatualizadas.

| Modalidade | Conjunto principal planejado |
| - | - |
| Texto | Artificial Analysis Intelligence Index, além de Humanity's Last Exam, Terminal-Bench, τ³-bench, AA-LCR, IFBench, AA-Omniscience e um Venice Openness Score |
| Imagem | Elo de preferência humana das arenas da Artificial Analysis e da LMArena, GenEval 2 e uma taxa de recusa excessiva |
| Vídeo | Elo de texto para vídeo (com e sem áudio) e de imagem para vídeo da Artificial Analysis, texto para vídeo da LMArena |
| Texto para fala | Elo da Artificial Analysis Speech Arena, taxa de erro de palavras, tempo até o primeiro áudio |
| Fala para texto | Taxa de erro de palavras da Artificial Analysis, Open ASR Leaderboard, fator de velocidade |
| Música | Artificial Analysis Music Arena (instrumental e vocais) |
| Embeddings | MTEB Multilingual, RTEB e um conjunto de recuperação reservado da Venice |

O conjunto é revisado a cada trimestre. Um benchmark passa a ser uma verificação mínima, deixando de ser principal, quando os modelos de fronteira o saturam ou quando ele falha em uma auditoria de contaminação.

## Dados legíveis por máquina

O catálogo por trás destas páginas é publicado como JSON em [`/data/model-catalog.json`](https://docs.venice.ai/data/model-catalog.json) e reconstruído a cada sincronização horária. Ele é adequado para comparação, análise e agentes; para escolher um modelo em tempo de execução, chame [`GET /models`](https://docs.venice.ai/pt-BR/api-reference/endpoint/models/list).

| Campo | Conteúdo |
| - | - |
| `version` | Versão do schema, atualmente `1` |
| `generatedAt` | Horário ISO 8601 do último build que alterou os dados |
| `counts` | Totais de modelos e famílias, no geral e por modalidade |
| `providers` | Criadores de modelos indexados por slug, com `name` e `logo` |
| `families` | Array de famílias: `slug`, `name`, `modality`, `task`, `provider`, `description`, `primary` (o ID da variante padrão), `variants` (IDs de modelo), `created` e `updated` (segundos Unix), `privacy` (todos os níveis oferecidos), `uncensored` e `openWeights` |
| `models` | Objeto indexado por ID de modelo: `name`, `type` (como em `GET /models`), `modality`, `task`, `variant`, `provider`, `family` (o slug da sua família), `privacy`, um bloco de limites e capacidades com o nome da modalidade (`text`, `image`, `video`, `audio` ou `embedding`), `pricing` na unidade nativa, `headline` (o preço de referência acima) e `media` (renderizações de referência) |
| `benchmarks` | Definições de benchmarks; `null` até que os benchmarks sejam publicados |
| `mediaSuite` | O conjunto de prompts de referência, por modalidade |

Campos sem valor são omitidos. Os preços estão em USD.

## Fontes de dados

O catálogo é montado a partir de endpoints públicos que você mesmo pode chamar:

* [`GET /models`](https://docs.venice.ai/pt-BR/api-reference/endpoint/models/list) para especificações, capacidades e preços.
* [`POST /video/quote`](https://docs.venice.ai/pt-BR/api-reference/endpoint/video/quote) para preços de vídeo.
* [`GET /models/traits`](https://docs.venice.ai/pt-BR/api-reference/endpoint/models/traits) para padrões como `default_code`.

Os preços estão em USD. O DIEM é cobrado em paridade.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.