aisplice

Riferimento API

Embedding

Nessun modello lo supporta ancora

Al momento nessun modello del catalogo supporta questa route. La pagina resta come riferimento.
POST/v1/embeddings

Embedding vettoriali in formato OpenAI — text-embedding-3, jina-embeddings, voyage ed equivalenti di altri fornitori. Fatturazione in base ai token di input.

#Parametri della richiesta

  • modelstringobbligatorio

    Un ID di modello di embedding, per esempio text-embedding-3-small.

  • inputstring | arrayobbligatorio

    Una stringa o un array — la risposta restituisce i vettori nello stesso ordine.

  • dimensionsintegerfacoltativo

    Tronca il vettore sui modelli che supportano le dimensioni Matryoshka.

  • encoding_formatstringfacoltativo

    "float" (predefinito) o "base64" per un payload compatto.

#Errori correlati

  • 400 invalid_request_errorCorpo malformato o parametro non supportato per questo modello.
  • 401Bearer token non valido o mancante. Su questo percorso non c'è error.code — basati sullo stato.
  • 402 insufficient_user_quotaIl saldo del portafoglio non copre la stima pre-riservata.
  • 429Limitazione per chiave. Corpo vuoto; attendi Retry-After. Un 429 che contiene insufficient_user_quota indica invece un limite di spesa giornaliero.
  • 503 model_not_foundModello sconosciuto, oppure nessun canale funzionante lo serve al momento.

Tabella completa dei codici di errore →

#Esempio di richiesta

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"]
  }'

#Risposta

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}
}

Non hai ancora risolto?

Inviaci l'ID richiesta o il messaggio di errore e verificheremo.