Referência da API

Embeddings

Nenhum modelo atende a isto ainda

Nenhum modelo do catálogo oferece esta rota no momento. A página continua disponível como referência.
POST/v1/embeddings

Embeddings vetoriais no formato da OpenAI — text-embedding-3, jina-embeddings, voyage e equivalentes de outros provedores. A cobrança é por tokens de entrada.

#Parâmetros da requisição

  • modelstringobrigatório

    ID de um modelo de embedding, por exemplo text-embedding-3-small.

  • inputstring | arrayobrigatório

    Uma string ou um array — a resposta retorna os vetores na mesma ordem.

  • dimensionsintegeropcional

    Trunca o vetor nos modelos que suportam dimensões Matryoshka.

  • encoding_formatstringopcional

    "float" (padrão) ou "base64" para um payload compacto.

#Erros relacionados

  • 400 invalid_request_errorCorpo malformado ou parâmetro não suportado por este modelo.
  • 401Bearer token inválido ou ausente. Não há error.code neste caminho — verifique o status.
  • 402 insufficient_user_quotaO saldo da carteira não cobre a estimativa pré-reservada.
  • 429Limitação por chave. Corpo vazio; aguarde o Retry-After. Um 429 que traz insufficient_user_quota indica, na verdade, o limite de gastos diário.
  • 503 model_not_foundModelo desconhecido, ou nenhum canal saudável o atende no momento.

Tabela completa de códigos de erro →

#Exemplo de requisição

curl https://www.aisplice.store/v1/embeddings \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": ["hello world", "another sentence"]
  }'

#Resposta

response.json
{
  "object": "list",
  "model": "text-embedding-3-small",
  "data": [
    {"object": "embedding", "index": 0, "embedding": [0.0023, -0.0091, …]},
    {"object": "embedding", "index": 1, "embedding": [0.0154,  0.0007, …]}
  ],
  "usage": {"prompt_tokens": 8, "total_tokens": 8}
}

Ainda com problemas?

Envie para nós o ID da requisição ou a mensagem de erro e vamos investigar.