Source: https://ailoot.ai/models/pt-pt/qwen-qwen3-embedding-4b/ Canonical: https://ailoot.ai/models/pt-pt/qwen-qwen3-embedding-4b/ Language: pt-pt # Qwen: Qwen3 Embedding 4B [Markdown](https://ailoot.ai/models/pt-pt/qwen-qwen3-embedding-4b/index.md) · [JSON](https://ailoot.ai/models/pt-pt/qwen-qwen3-embedding-4b/facts.json) ## [Qwen: Qwen3 Embedding 4B](https://ailoot.ai/models/pt-pt/qwen-qwen3-embedding-4b/) Qwen3-Embedding-4B representa texto como vetores semânticos para recuperação multilingue de informação, pesquisa de código, classificação e agrupamento. Este modelo 4B suporta sequências de 32K tokens e dimensões vetoriais personalizáveis de 32 a 2 560. - [**Ailoot Ultra · Embeddings** `POST /v1/embeddings` `qwen/qwen3-embedding-4b`](https://ailoot.ai/models/pt-pt/qwen-qwen3-embedding-4b/#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. Qwen3-Embedding-4B é a edição 4B de embeddings de texto da família de embeddings e reordenação da Qwen. Construído sobre o modelo de base denso Qwen3, converte um segmento de texto numa representação numérica do seu significado. A Qwen identifica a recuperação de texto, a recuperação de código, a classificação, o agrupamento e a extração de textos paralelos como áreas de aplicação. É útil quando uma aplicação precisa de encontrar passagens relacionadas, agrupar registos semelhantes ou comparar texto entre línguas. A saída do modelo é um vetor de embedding, não uma resposta de conversa nem um documento reescrito. Esta edição específica tem um comprimento de sequência de 32K tokens e uma dimensão de embedding de até 2 560. Suporta dimensões de saída personalizáveis de 32 a 2 560 através de Matryoshka Representation Learning. O comprimento do vetor escolhido afeta a forma como a representação é armazenada e comparada, pelo que deve ser consistente entre os vetores de consulta e de documento numa mesma coleção. Qwen3-Embedding-8B tem um tamanho de modelo diferente e um máximo de 4 096 dimensões; nem esse tamanho de saída nem a identidade do modelo 8B se transferem para esta edição 4B. Um índice existente deve manter as suas próprias opções de representação consistentes. O fabricante descreve suporte de mais de 100 línguas, incluindo linguagens de programação, com recuperação multilingue, entre línguas e de código. Uma pesquisa exemplificativa num centro de ajuda pode comparar a pergunta de um utilizador com passagens escritas em várias línguas e devolver depois as passagens originais que correspondem ao tema. Uma pesquisa de código pode comparar uma descrição em linguagem natural com funções relevantes e a respetiva documentação. Preserve títulos significativos, termos do domínio e identificadores ao preparar o texto, e mantenha cada passagem representada ligada à sua fonte, para que a aplicação possa mostrar o material correspondente. Qwen3-Embedding-4B tem em conta as instruções. A Qwen recomenda dar a cada consulta uma descrição da tarefa numa frase, adaptada à relação de recuperação pretendida, e recomenda instruções em inglês para cenários multilingues. O exemplo direto coloca Instruct: antes da descrição da tarefa e Query: antes do texto da consulta. Os documentos de recuperação são codificados sem essa instrução da consulta. Uma instrução prática original pode especificar a procura de passagens de documentação que expliquem um erro comunicado ou de excertos de código-fonte que implementem o comportamento descrito. Isto orienta a representação para a pergunta da aplicação, em vez de pedir ao modelo que escreva uma resposta. Os exemplos oficiais codificam os textos das consultas e dos documentos, comparam os seus embeddings através da similaridade do cosseno e demonstram o pooling do estado oculto do último token, seguido de normalização. Nesse exemplo de nível mais baixo, a entrada é truncada numa definição escolhida de 8 192 tokens; o comprimento de sequência documentado do modelo continua a ser 32K. Para material longo, decida que passagens representar e certifique-se de que o truncamento não descarta silenciosamente a parte de que a consulta precisa. Armazene os vetores com referências estáveis às fontes, compare a consulta preparada com a coleção e devolva as passagens associadas por ordem de similaridade. O modelo de embeddings da Qwen utiliza uma abordagem dual-encoder, enquanto os seus modelos de reordenação separados utilizam um cross-encoder para avaliar pares consulta–documento. A publicação descreve a utilização conjunta destes módulos: os embeddings encontram os candidatos iniciais, e um reranker pode depois aperfeiçoar a sua ordem. Qwen3-Embedding-4B fornece, por si só, a representação de um único texto. O seu vetor não é uma pontuação de reordenação, uma afirmação verificada nem uma resposta gerada. Se o processo final responder a perguntas a partir do material recuperado, as passagens selecionadas das fontes continuam a ser os elementos que fundamentam essa etapa posterior. **Ailoot Ultra · Embeddings** `POST /v1/embeddings` `qwen/qwen3-embedding-4b` [`qwen/qwen3-embedding-4b`](https://ailoot.ai/models/pt-pt/#m=qwen%2Fqwen3-embedding-4b&route=Ultra&caller=qwen%2Fqwen3-embedding-4b&fmt=embeddings) Alibaba /`qwen/qwen3-embedding-4b` ### Introdução Qwen3-Embedding-4B representa texto como vetores semânticos para recuperação multilingue de informação, pesquisa de código, classificação e agrupamento. Este modelo 4B suporta sequências de 32K tokens e dimensões vetoriais personalizáveis de 32 a 2 560. Entradas aceites Texto · token\_ids Resultados embedding ### Disponível no Ailoot · entradas e métodos **Ailoot Ultra · Embeddings** `POST /v1/embeddings` Entrada `text`, `token_ids` Saída `embedding` Formato de saída json | Campo | Tipo | Requisito | Valores e limites | Predefinição | | --- | --- | --- | --- | --- | | Campo`model` | Tipo`string` | RequisitoObrigatório | Valores e limites qwen/qwen3-embedding-4b | Predefinição— | | Campo`input` | Tipo`string\|string[]\|integer[]\|integer[][]` | RequisitoObrigatório | Valores e limites Número mínimo de elementos: 1 Condições: Lote homogéneo não vazio. Os IDs de tokens são números inteiros não negativos. Orçamento de entrada: Máximo: 32 768 · Unidade de texto: bytes UTF8 · Unidade de tokens: elementos do array de tokens | Predefinição— | | Campo`encoding_format` | Tipo`string` | RequisitoOpcional | Valores e limites float | Predefiniçãofloat | | Campo`dimensions` | Tipo`integer` | RequisitoNão suportado | Valores e limites Mínimo: 1 | Predefinição— | | Campo`user` | Tipo`json_value` | RequisitoOpcional | Valores e limites Condições: A fonte permite este campo de metadados JSON; a semântica exata a montante depende do modelo. | Predefinição— | | Campo`session_id` | Tipo`json_value` | RequisitoOpcional | Valores e limites Condições: A fonte permite este campo de metadados JSON; a semântica exata a montante depende do modelo. | Predefinição— | | Campo`trace` | Tipo`json_value` | RequisitoOpcional | Valores e limites Condições: A fonte permite este campo de metadados JSON; a semântica exata a montante depende do modelo. | Predefinição— | | Campo`provider` | Tipo`object` | RequisitoOpcional | Valores e limites Condições: provider.options rejeitado | Predefinição— | Combinações de materiais de entrada **text\_to\_embedding** Parâmetros e ciclo de vida do método | Parâmetro | Contrato | | --- | --- | | Parâmetro`content_type` | Contratoapplication/json | | Parâmetro`required` | Contratomodel, input | | Parâmetro`input_shapes` | Contratostring, string\[\], nonnegative\_integer\_token\_array, nonnegative\_integer\_token\_array\[\] | | Parâmetro`encoding_format` | Contratofloat | | Parâmetro`dimensions_override` | Contratofalse | | Parâmetro`max_input_budget_units` | Contrato32768 | | Parâmetro`multimodal_objects` | Contratofalse | | Parâmetro`material_types` | Contratotext, token\_ids | Ciclo de vida: `synchronous_json` Guarde o índice e a dimensão de cada vetor. O nome do modelo multimodal não permite objetos de imagem neste caminho exato. ### 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 | Configuração | Tabela de tarifas | Custo | | --- | --- | --- | | ConfiguraçãoTarifas base dos tokens | Tabela de tarifasTarifa base | Custo Entrada · Tokens de entrada **$0.00004** / 1K tokens Saída · Tokens de saída **$0** / 1K tokens Entrada · Leitura da cache **—** / 1K tokens Entrada · Escrita na cache **—** / 1K tokens Entrada · Escrita na cache, 1 hora **—** / 1K tokens | 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 · Embeddings curlPython SDK ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" python3 - <<'PY_REQUEST' import json,os from pathlib import Path p=json.loads('{"model": "qwen/qwen3-embedding-4b", "input": ["First document", "Second document"]}') Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/embeddings \ -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 r=json.loads(Path("result.json").read_text()) for x in r.get("data",[]): print(json.dumps({"index":x.get("index"),"embedding":x.get("embedding")})) PY_RESULT ``` ```python from openai import OpenAI import os client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) result=client.embeddings.create(model='qwen/qwen3-embedding-4b',input=["First document","Second document"]) print(result) for item in result.data:print(item.index,item.embedding) ``` ### Receber e guardar os resultados #### Ailoot Ultra · Embeddings json ##### Guardar todos os resultados concluídos Guarde cada resposta, ficheiro e parte de conteúdo devolvidos na íntegra. Guarde cada vetor com o respetivo índice. O número de vetores tem de ser igual ao número de entradas; as dimensões têm de ser consistentes. ##### Se for necessário verificar a resposta original Não é introduzido nenhum endpoint de tarefas de embeddings. Campos da resposta | Campo | Tipo | | --- | --- | | Campo`object` | Tipostring | | Campo`model` | Tipostring | | Campo`data[].index` | Tipointeger | | Campo`data[].embedding` | Tipofinite float\[\] | | Campo`usage` | Tipoobject | Erros e passos seguintes | Resposta | Condição | Passo seguinte | | --- | --- | --- | | Resposta400 · `invalid_request_error` | CondiçãoCampos obrigatórios, representação do material ou valor do parâmetro inválidos | Passo seguinteCorrija os campos indicados antes de um novo pedido de criação. | ### Aliases #### Aliases do modelo **Ailoot Ultra** [`qwen/qwen3-embedding-4b`](https://ailoot.ai/models/pt-pt/#m=qwen%2Fqwen3-embedding-4b&route=Ultra&caller=qwen%2Fqwen3-embedding-4b&fmt=embeddings) #### Aliases dos caminhos dos métodos Use os caminhos dos métodos indicados acima. #### IDs de chamada relacionados [`qwen/qwen3-embedding-4b`](https://ailoot.ai/models/pt-pt/#m=qwen%2Fqwen3-embedding-4b&route=Ultra&caller=qwen%2Fqwen3-embedding-4b&fmt=embeddings) FAQ · Qwen: Qwen3 Embedding 4B Que entradas e resultados estão disponíveis? `POST /v1/embeddings` · `qwen/qwen3-embedding-4b`: `text`, `token_ids` → `embedding` Que campos utiliza o pedido? `POST /v1/embeddings` · `qwen/qwen3-embedding-4b`: `model`, `input`, `encoding_format`, `provider` Que limites se aplicam? `POST /v1/embeddings` · `qwen/qwen3-embedding-4b`: `input.budget.maximum`: `32768` (bytes UTF8); `input.min_items`: `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.