ShareAI Platform Docs

Criar embeddings de texto

Gere embeddings de texto com ShareAI para pesquisa semântica, recuperação e similaridade, com formatos de entrada suportados e requisitos de modelo.

Ver como Markdown
Nesta página
POST https://api.shareai.now/api/v1/embeddings

Converter um ou mais textos em vetores de incorporação.

URL Base
https://api.shareai.now
Autenticação
Chave de API Bearer ou token de acesso OAuth aprovado

Escolha um modelo de incorporação ativado no ShareAI e permitido pelas suas credenciais. Modelos de chat não podem ser substituídos por modelos de incorporação. A disponibilidade do modelo e as opções suportadas dependem do fornecedor configurado.

Enviar uma solicitação#

cURL

curl --fail-with-body --request POST \
  "https://api.shareai.now/api/v1/embeddings" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_EMBEDDING_MODEL",
  "input": [
    "How do I connect a device?",
    "Where can I read my usage?"
  ],
  "encoding_format": "float"
}'

Campos da solicitação#

CampoValor
modelUm ID de modelo de incorporação ativado.
inputUma string não vazia ou um array de até 128 strings não vazias.
encoding_formatfloat ou base64.
dimensionsInteiro opcional de 1 a 65536; o modelo selecionado deve suportá-lo.

Leia os vetores#

Leia o data array e use o resultado de cada index para corresponder sua incorporação à entrada. Mantenha o mesmo modelo e dimensões ao incorporar seus documentos e consultas de pesquisa. O resultado também inclui usage.

Lote dentro dos limites#

O texto de entrada combinado é limitado a 256 KiB. As respostas são síncronas e limitadas a 2 MiB, portanto, vetores ou lotes grandes podem exceder o limite de resposta. Reduza o tamanho do lote ou use dimensões menores suportadas. Arrays de IDs de tokens não são aceitos.

Autenticação e disponibilidade#

Um token de acesso OAuth aprovado pode substituir a chave da API. Solicitações financiadas pela conta exigem surcharge e um plano aceito. Restrições de modelo e fornecedor ainda se aplicam. Se o modelo não estiver ativado para incorporações, escolha um modelo de incorporação disponível; alterar as credenciais não pode ativar um modelo.

Uso#

Incorporações consomem tokens de entrada. Verifique os preços do modelo antes de executar um lote grande e use Console de Utilização para revisar a atividade. Lide com erros de validação, autorização e disponibilidade antes de tentar novamente.

Última atualização em 15 de setembro de 2026

Documentação da Plataforma ShareAI
Toda a documentação

Pesquisar por título ou conteúdo.

Perguntar sobre esta página

Escolha um assistente para explorar esta página. Também pode copiar a página e colá-la na sua conversa.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI