Embeddings API

Bruk CometAPI embeddings når appen din trenger vektorer for semantisk søk, klynging, anbefalinger eller retrieval. Send tekst til /v1/embeddings, lagre den returnerte vektoren, og søk i den med vektordatabasen din.

Opprett en embedding

Bruk en model ID med støtte for embeddings fra Models page eller model directory. Eksemplene nedenfor kaller den OpenAI-kompatible Embeddings API.

Disse eksemplene bruker plassholderen your-embedding-model-id. Erstatt den med en tilgjengelig embedding model ID fra Models page eller model directory før du kjører forespørselen.

Åpne Create embeddings for å bruke playground og endepunktskjemaet.

import os
import requests

response = requests.post(
    "https://api.cometapi.com/v1/embeddings",
    headers={
        "Authorization": "Bearer " + os.environ["COMETAPI_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "model": "your-embedding-model-id",
        "input": "CometAPI lets developers use many model providers.",
    },
    timeout=30,
)

response.raise_for_status()
result = response.json()
print(len(result["data"][0]["embedding"]))

const response = await fetch("https://api.cometapi.com/v1/embeddings", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "your-embedding-model-id",
    input: "CometAPI lets developers use many model providers.",
  }),
});

if (!response.ok) {
  throw new Error(await response.text());
}

const result = await response.json();
console.log(result.data[0].embedding.length);

curl https://api.cometapi.com/v1/embeddings \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-embedding-model-id",
    "input": "CometAPI lets developers use many model providers."
  }'

Eksempel på svar

Et vellykket svar kan se slik ut. Svaret inkluderer én vektor for hvert input-element; vektoren nedenfor er forkortet for lesbarhet:

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [
        -0.0021,
        -0.0491,
        0.0209
      ]
    }
  ],
  "model": "your-embedding-model-id",
  "usage": {
    "prompt_tokens": 10,
    "total_tokens": 10
  }
}

Batch-input

Send en matrise med strenger når du vil ha flere vektorer fra én forespørsel:

cURL

curl https://api.cometapi.com/v1/embeddings \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-embedding-model-id",
    "input": [
      "Create an API key",
      "Change the base URL",
      "Retry after a rate limit"
    ]
  }'

Eksempel på modelloppføringer

Dette eksempelet på et svar fra modellkatalogen viser /api/models-konvolutten og formen på én OpenAI-kompatibel embedding-modelloppføring. Noen embedding-oppføringer bruker en tom model_type; velg en embedding-modell etter ID og endpoint-støtte i stedet for å stole kun på det feltet.

cURL

curl https://api.cometapi.com/api/models

{
  "success": true,
  "page": 1,
  "page_size": 20,
  "total": 302,
  "data": [
    {
      "created": 1757904564,
      "id": "your-embedding-model-id",
      "code": "your-embedding-model-id",
      "provider": "ExampleProvider",
      "provider_code": "example",
      "name": "Example embedding model",
      "model_type": "embedding",
      "features": [
        "text-embedding"
      ],
      "endpoints": [
        "openai"
      ],
      "pricing": {
        "currency": "USD / M Tokens",
        "input": 0.1,
        "output": null,
        "per_request": null,
        "per_second": null
      }
    }
  ]
}

Vanlige feil

Inndata er for lange

Del opp lange dokumenter i biter før embedding.

Feil modelltype

Velg en modell med støtte for embedding fra modellkatalogen.

Manglende samsvar i vektordimensjoner

Behold samme modell og dimensjoner for én vektorindeks.

API-nøkkel mangler

Send Authorization: Bearer $COMETAPI_KEY.

Feilkoder og strategi for nye forsøk

400

Ikke prøv på nytt før inndata, model ID eller dimensjonsinnstillingen er rettet.

401

Ikke prøv på nytt før API-nøkkelen er til stede og gyldig.

404

Sjekk base-URL, sti og model ID før du prøver på nytt.

429

Prøv på nytt med eksponentiell backoff og reduser batchstørrelse eller samtidighet.

500 or 503

Prøv på nytt med backoff ved midlertidige provider- eller tjenestefeil.

For implementeringsmønstre, se Feilkoder og strategi for nye forsøk og Rate limits and concurrency.

Priser og modellkatalog

Modellside

Les hvordan CometAPI eksponerer model IDs i dokumentasjonen.

Modellkatalog

Utforsk tilgjengelige modeller og funksjoner.

Priser

Sjekk priser før du kaller en modell.

Innholdsmoderering

API-nøkler

Opprett en embedding

Eksempel på svar

Batch-input

Eksempel på modelloppføringer

Vanlige feil

Feilkoder og strategi for nye forsøk

Priser og modellkatalog

Modellside

Modellkatalog

Priser

​Opprett en embedding

​Eksempel på svar

​Batch-input

​Eksempel på modelloppføringer

​Vanlige feil

​Feilkoder og strategi for nye forsøk

​Priser og modellkatalog

Modellside

Modellkatalog

Priser

Opprett en embedding

Eksempel på svar

Batch-input

Eksempel på modelloppføringer

Vanlige feil

Feilkoder og strategi for nye forsøk

Priser og modellkatalog