Embeddings API

Usa CometAPI embeddings cuando tu aplicación necesite vectores para búsqueda semántica, agrupamiento, recomendaciones o recuperación. Envía texto a /v1/embeddings, almacena el vector devuelto y búscalo con tu base de datos vectorial.

Crear un embedding

Usa un model ID con capacidad de embedding desde la página de Models o el directorio de modelos. Los ejemplos de abajo llaman a la API de Embeddings compatible con OpenAI.

Estos ejemplos usan el marcador de posición your-embedding-model-id. Sustitúyelo por un model ID de embedding disponible de la página de Models o del directorio de modelos antes de ejecutar la solicitud.

Abre Create embeddings para usar el playground y el esquema del endpoint.

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

Ejemplo de respuesta

Una respuesta correcta puede verse así. La respuesta incluye un vector por cada elemento de entrada; el vector de abajo está acortado para facilitar la lectura:

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

Entrada por lotes

Envía un array de cadenas cuando quieras varios vectores en una sola solicitud:

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

Registros de ejemplo de modelos

Esta respuesta de ejemplo del catálogo de modelos muestra el sobre de /api/models y la forma de un registro de modelo de embedding compatible con OpenAI. Algunos registros de embedding usan un model_type vacío; elige un modelo de embedding por ID y compatibilidad de endpoint en lugar de basarte solo en ese campo.

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

Errores comunes

Input too long

Divide los documentos largos en fragmentos antes de generar embeddings.

Wrong model type

Elige un modelo con capacidad de embedding del directorio de modelos.

Vector dimensions mismatch

Mantén el mismo modelo y dimensiones para un índice vectorial.

Missing API key

Envía Authorization: Bearer $COMETAPI_KEY.

Códigos de error y estrategia de reintento

400

No reintentes hasta corregir la entrada, el model ID o la configuración de dimensiones.

401

No reintentes hasta que la clave de API esté presente y sea válida.

404

Verifica la URL base, la ruta y el model ID antes de reintentar.

429

Reintenta con backoff exponencial y reduce el tamaño del lote o la concurrencia.

500 or 503

Reintenta con backoff para errores transitorios del proveedor o del servicio.

Para patrones de implementación, consulta Códigos de error y estrategia de reintento y Límites de tasa y concurrencia.

Precios y directorio de modelos

Models page

Lee cómo CometAPI expone los model ID en la documentación.

Model directory

Explora la disponibilidad y las capacidades de los modelos.

Pricing

Consulta los precios antes de llamar a un modelo.

Moderación de contenido

Claves API

Crear un embedding

Ejemplo de respuesta

Entrada por lotes

Registros de ejemplo de modelos

Errores comunes

Códigos de error y estrategia de reintento

Precios y directorio de modelos

Models page

Model directory

Pricing

​Crear un embedding

​Ejemplo de respuesta

​Entrada por lotes

​Registros de ejemplo de modelos

​Errores comunes

​Códigos de error y estrategia de reintento

​Precios y directorio de modelos

Models page

Model directory

Pricing

Crear un embedding

Ejemplo de respuesta

Entrada por lotes

Registros de ejemplo de modelos

Errores comunes

Códigos de error y estrategia de reintento

Precios y directorio de modelos