Source: https://ailoot.ai/models/pt-pt/cohere-rerank-v3-5/
Canonical: https://ailoot.ai/models/pt-pt/cohere-rerank-v3-5/
Language: pt-pt

# Cohere: Rerank v3.5

[Markdown](https://ailoot.ai/models/pt-pt/cohere-rerank-v3-5/index.md) · [JSON](https://ailoot.ai/models/pt-pt/cohere-rerank-v3-5/facts.json)

## [Cohere: Rerank v3.5](https://ailoot.ai/models/pt-pt/cohere-rerank-v3-5/)

Cohere Rerank 3.5 reordena texto candidato e registos semiestruturados pela relevância para uma consulta. Suporta mais de 100 idiomas e um contexto de 4096 tokens para refinar resultados de pesquisa por palavras-chave ou semântica antes de uma resposta ou apresentação de pesquisa.

- [**Ailoot Ultra · Reordenação** `POST /v1/rerank` `cohere/rerank-v3.5`](https://ailoot.ai/models/pt-pt/cohere-rerank-v3-5/#method-0)

Sobre o modelo

Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo.

Cohere Rerank 3.5 é um modelo multilingue para ordenação por relevância de documentos candidatos e texto semiestruturado. Avalia cada candidato em relação a uma consulta e devolve uma lista de resultados reordenada com pontuações de relevância. Pode refinar candidatos obtidos através de pesquisa por palavras-chave ou semântica e selecionar passagens para uma resposta aumentada por recuperação. A sua tarefa é melhorar a ordenação dos elementos de prova, em vez de gerar uma resposta livre ou criar um novo índice do corpus.

O identificador exato do fabricante é rerank-v3.5. Utiliza um contexto de 4096 tokens, distinto do contexto de 32K de Rerank 4 Pro e Fast. Os tokens da consulta e do documento contam em conjunto para essa janela por candidato. O guia de preparação específico do modelo trunca uma consulta depois dos primeiros 2048 tokens e descreve blocos de documentos de 4093 tokens antes de ter em conta a consulta. Mantenha a consulta focada e prepare passagens candidatas que contenham a informação necessária para avaliar a relação pedida.

Forneça a consulta e uma lista de cadeias de texto candidatas. Cada resultado contém um índice que aponta para a posição original do documento e uma pontuação de relevância; top\_n escolhe quantos resultados ordenados reter. Sem esse parâmetro, o fluxo de trabalho documentado do fabricante devolve todos os resultados. Preserve os identificadores dos documentos independentemente da pontuação para que a passagem principal continue rastreável até à política, registo de produto ou mensagem original.

Rerank 3.5 suporta mais de 100 idiomas, incluindo material em inglês e noutros idiomas. Uma consulta pode conter vários aspetos da necessidade, como o produto, a situação do utilizador e o procedimento pretendido. Para registos estruturados, a versão V2 removeu objetos de documento em bruto e recomenda cadeias YAML. Mantenha os campos úteis numa ordem deliberada, com o conteúdo decisivo antes de metadados menos relevantes, porque cadeias longas podem ser truncadas. Isto funciona para títulos e conteúdo, atributos de produtos ou assunto e corpo de uma mensagem.

A referência V2 do fabricante utiliza max\_tokens\_per\_doc para truncamento dos documentos, com o valor predefinido de 4096. O guia de preparação da Cohere descreve também a divisão de documentos longos em blocos; a entrada efetiva depende do fluxo de trabalho selecionado e das definições dos documentos. Para maior controlo, prepare passagens identificáveis, em vez de presumir que todas as secções de uma fonte longa continuam visíveis. Preserve contexto envolvente suficiente para distinguir uma passagem que contém a resposta de outra que apenas partilha o seu vocabulário.

Para o desempenho dos pedidos, a referência atual recomenda não enviar mais de 1 000 documentos de uma só vez. As pontuações de relevância são normalizadas entre 0 e 1, mas os valores dependem da consulta e dos candidatos e não constituem uma escala linear de correção. Utilize a ordenação para identificar elementos de prova úteis. Se precisar de um limiar de pontuação, escolha consultas representativas do domínio e passagens de relevância limítrofe para que o limiar reflita a tarefa real de recuperação.

Um fluxo de apoio prático pode reordenar secções candidatas da política de devoluções para uma pergunta sobre um artigo danificado e passar depois o texto de origem selecionado para uma etapa de redação da resposta. Uma pesquisa de correio eletrónico pode ordenar mensagens por uma questão específica e conservar o identificador da mensagem original com cada resultado. O resultado útil é a lista ordenada de elementos de prova. Mantenha o contexto mais curto de Rerank 3.5 e a preparação documental V2 associados a esse resultado, em vez de substituir os limites pelos de modelos posteriores.

**Ailoot Ultra · Reordenação** `POST /v1/rerank` `cohere/rerank-v3.5`

[`cohere/rerank-v3.5`](https://ailoot.ai/models/pt-pt/#m=cohere%2Frerank-v3.5&route=Ultra&caller=cohere%2Frerank-v3.5&fmt=rerank)

Cohere /`cohere/rerank-v3.5`

### Introdução

Cohere Rerank 3.5 reordena texto candidato e registos semiestruturados pela relevância para uma consulta. Suporta mais de 100 idiomas e um contexto de 4096 tokens para refinar resultados de pesquisa por palavras-chave ou semântica antes de uma resposta ou apresentação de pesquisa.

Entradas aceites

Texto

Resultados

Resultados ordenados

### Disponível no Ailoot · entradas e métodos

**Ailoot Ultra · Reordenação** `POST /v1/rerank`

Entrada

`text`

Saída

`rerank`

Formato de saída

json

| Campo | Tipo | Requisito | Valores e limites | Predefinição |
| --- | --- | --- | --- | --- |
| Campo`documents` | Tipo`array` | RequisitoObrigatório | Valores e limites | Predefinição— |
| Campo`model` | Tipo`string` | RequisitoObrigatório | Valores e limites cohere/rerank-v3.5 | Predefinição— |
| Campo`provider` | Tipo`schema` | RequisitoOpcional | Valores e limites | Predefinição— |
| Campo`query` | Tipo`string` | RequisitoObrigatório | Valores e limites | Predefinição— |
| Campo`session_id` | Tipo`string` | RequisitoOpcional | Valores e limites | Predefinição— |
| Campo`top_n` | Tipo`integer` | RequisitoOpcional | Valores e limites Mínimo: 1 | Predefinição— |
| Campo`trace` | Tipo`schema` | RequisitoOpcional | Valores e limites | Predefinição— |
| Campo`user` | Tipo`string` | RequisitoOpcional | Valores e limites | Predefinição— |
| Campo`documents[].text` | Tipo`string` | RequisitoOpcional | Valores e limites | Predefinição— |
| Campo`documents[].image` | Tipo`string` | RequisitoOpcional | Valores e limites | Predefinição— |

Combinações de materiais de entrada

**text\_rerank** · Obrigatório: query, documents array with minItems1

Parâmetros e ciclo de vida do método

| Parâmetro | Contrato |
| --- | --- |
| Parâmetro`content_type` | Contratoapplication/json |
| Parâmetro`required` | Contratomodel, query, documents |
| Parâmetro`material_types` | Contratotext |
| Parâmetro`optional_controls` | Contratoprovider, session\_id, top\_n, trace, user |
| Parâmetro`multimodal_input_binding` | Contratonull |

Ciclo de vida: `synchronous`

Envie o ID exato do modelo e conserve a resposta nativa completa.

### Tarifários

As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado.

Modo rápido

Não especificado Quando o modo rápido está selecionado

Modo flex

Não especificado Quando o modo flex está selecionado

Esforço máximo de raciocínio

Não especificado Quando o esforço máximo de raciocínio usa o ajuste predefinido (default)

#### Tarifas Ailoot

#### Preços por configuração

Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.

| Configuração | Tabela de tarifas | Unidade de faturação | Custo |
| --- | --- | --- | --- |
| ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Unidade de faturação— | Custo Entrada · Tokens de entrada **—** / 1K tokens Saída · Tokens de saída **—** / 1K tokens Entrada · Leitura da cache **—** / 1K tokens Entrada · Escrita na cache **—** / 1K tokens Entrada · Escrita na cache, 1 hora **—** / 1K tokens |
| ConfiguraçãoUltra | Tabela de tarifas— | Unidade de faturaçãopor unidade de pesquisa | Custo total · unidade de pesquisa **$0.002** por unidade de pesquisa |

O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. [Como funcionam a reserva e a liquidação →](https://ailoot.ai/docs/pt-pt/billing/reserve/)

### Exemplos de pedidos

#### Ailoot Ultra · Reordenação

Estrutura oficial do pedido preservada; exemplo de documentaçãoUse o material real do seu pedido e guarde o resultado completo

```json
{
  "documents": [
    "Paris is the capital of France.",
    "Berlin is the capital of Germany."
  ],
  "model": "cohere/rerank-v3.5",
  "query": "What is the capital of France?",
  "top_n": 3
}
```

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='cohere/rerank-v3.5'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/rerank \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT
```

### Receber e guardar os resultados

#### Ailoot Ultra · Reordenação

json

##### Guardar todos os resultados concluídos

Guarde cada resposta, ficheiro e parte de conteúdo devolvidos na íntegra.

São conservados todos os índices reais dos resultados, os valores finitos de relevance\_score e os objetos de documento originais. Os índices correspondem à matriz original de documentos. O JSON original completo é armazenado e devolvido apenas após a liquidação.

##### Se for necessário verificar a resposta original

Conserve a operação original e a resposta completa/parcial; não repita o POST.

Campos da resposta

| Campo | Tipo |
| --- | --- |
| Campo`model` | Tipostring |
| Campo`id` | Tipostring |
| Campo`provider` | Tipostring |
| Campo`results[].index` | Tipointeger |
| Campo`results[].relevance_score` | Tiponumber |
| Campo`results[].document.text` | Tipostring |
| Campo`results[].document.image` | Tipostring |
| Campo`usage.search_units` | Tipointeger |
| Campo`usage.total_tokens` | Tipointeger |
| Campo`usage.cost` | Tiponumber |

Erros e passos seguintes

| Resposta | Condição | Passo seguinte |
| --- | --- | --- |
| Resposta400 · `invalid_request_error` | CondiçãoCampo obrigatório, representação ou valor inválido | Passo seguinteCorrija o campo indicado no pedido. |

### Aliases

#### Aliases do modelo

**Ailoot Ultra** [`cohere/rerank-v3.5`](https://ailoot.ai/models/pt-pt/#m=cohere%2Frerank-v3.5&route=Ultra&caller=cohere%2Frerank-v3.5&fmt=rerank)

#### Aliases dos caminhos dos métodos

Use os caminhos dos métodos indicados acima.

#### IDs de chamada relacionados

[`cohere/rerank-v3.5`](https://ailoot.ai/models/pt-pt/#m=cohere%2Frerank-v3.5&route=Ultra&caller=cohere%2Frerank-v3.5&fmt=rerank)

FAQ · Cohere: Rerank v3.5

Que entradas e resultados estão disponíveis?

`POST /v1/rerank` · `cohere/rerank-v3.5`: `text` → `rerank`

Que campos utiliza o pedido?

`POST /v1/rerank` · `cohere/rerank-v3.5`: `documents`, `model`, `provider`, `query`, `session_id`, `top_n`, `trace`, `user`

Que limites se aplicam?

`POST /v1/rerank` · `cohere/rerank-v3.5`: `top_n.minimum`: `1`

Ligue o Ailoot ao Claude Code, OpenCode, Hermes ou à sua aplicação.

## A empresa e a sua carteira de projetos

A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões.

## Compre tokens com desconto.

Desconto por subscrição para trabalho regular. Códigos promocionais — até 50% na compra de tokens.

Subscrição

Escolha um plano com desconto para os pedidos regulares.

Código promocional até 50%

Introduza o código na compra. O preço é recalculado conforme a campanha em vigor.

Custos no histórico

O modelo, os tokens e o montante são guardados para cada pedido.

[Escolher subscrição](https://ailoot.ai/docs/pt-pt/billing/subscriptions/) · [Ver preços dos modelos](https://ailoot.ai/models/pt-pt/)

## Ligue a API ao produto que vende.

SaaS, aplicações e bots — ao abrigo da oferta e do contrato de licença Ailoot. Para revenda, peça uma licença de revendedor.

Aplicação comercial

Integre geração de texto, imagens, vídeo e som nas funcionalidades pagas do seu serviço.

Licença de revendedor

Envie uma descrição do projeto e do modelo de acesso. Peça condições escritas de utilização e revenda.

Documentos no site

A oferta, o contrato de licença e a política de tratamento de dados estão disponíveis antes da ligação.

[Pedir licença de revendedor](mailto:support@ailoot.ai) · [Oferta e contrato de licença](https://ailoot.ai/legal/offer?lang=pt-pt)

## Ailoot · A empresa e a sua carteira de projetos





A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI.





A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões.





A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.
