Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Usa la documentación de modelos de texto de CometAPI haciendo coincidir el formato de tu solicitud con la página que lo implementa. Para chat compatible con OpenAI, empieza con Chat Completions o Responses; para formatos nativos del proveedor, usa la página del proveedor correspondiente.

Elige una API de texto

Chat Completions

Envía mensajes de chat compatibles con OpenAI con un array de messages.

Responses

Usa razonamiento, salida multimodal y herramientas integradas a través de la Responses API.

Anthropic Messages

Llama flujos de trabajo de Messages compatibles con Claude con campos nativos del proveedor.

Gemini content generation

Envía solicitudes nativas de generación de contenido de Gemini.

Llama a un modelo de texto

Usa cualquier model ID con capacidad de texto de la Models page o del model directory. Los ejemplos siguientes llaman al endpoint Chat Completions compatible con OpenAI.
Estos ejemplos usan el placeholder your-model-id. Reemplázalo por un model ID de texto disponible en la Models page o en el model directory antes de ejecutar la solicitud.
import os
import requests

response = requests.post(
    "https://api.cometapi.com/v1/chat/completions",
    headers={
        "Authorization": "Bearer " + os.environ["COMETAPI_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "model": "your-model-id",
        "messages": [
            {
                "role": "user",
                "content": "Write one sentence about CometAPI.",
            }
        ],
    },
    timeout=30,
)

response.raise_for_status()
result = response.json()
print(result["choices"][0]["message"]["content"])

Ejemplo de respuesta

Una respuesta correcta puede verse así. Los valores de los campos varían según el modelo y la solicitud:
{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1779960520,
  "model": "your-model-id",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "CometAPI lets developers route model requests through one API surface."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 14,
    "total_tokens": 26
  }
}

Registros de modelos de ejemplo

Este ejemplo de respuesta del catálogo de modelos muestra el contenedor /api/models y la estructura de un registro de modelo de texto. No es una lista completa de modelos.
cURL
curl https://api.cometapi.com/api/models
{
  "success": true,
  "page": 1,
  "page_size": 20,
  "total": 302,
  "data": [
    {
      "created": 1773798949,
      "id": "your-text-model-id",
      "code": "your-text-model-id",
      "provider": "ExampleProvider",
      "provider_code": "example",
      "name": "Example text model",
      "model_type": "text",
      "features": [
        "text-to-text"
      ],
      "endpoints": "{\n  \"openai-chat\": {\n    \"path\": \"/v1/chat/completions\",\n    \"method\": \"POST\"\n  }\n}",
      "pricing": {
        "currency": "USD / M Tokens",
        "input": 0.5,
        "output": 1.5,
        "per_request": null,
        "per_second": null
      }
    }
  ]
}

Errores comunes

Envía Authorization: Bearer $COMETAPI_KEY.
Usa https://api.cometapi.com/v1 para solicitudes compatibles con OpenAI.
Elige un modelo con capacidad de texto en la Models page.
Elimina los campos opcionales y luego vuelve a añadirlos uno por uno.

Códigos de error y estrategia de reintento

No reintentes hasta que se corrija el cuerpo de la solicitud.
No reintentes hasta que la API key esté presente y sea válida.
Verifica la base URL, la ruta y el model ID antes de reintentar.
Reintenta con backoff exponencial y reduce la concurrencia.
Reintenta con backoff para errores transitorios del proveedor o del servicio.
Para patrones de implementación, consulta Error codes and retry strategy y Rate limits and concurrency.

Precios y directorio de modelos

Models page

Lee cómo CometAPI expone los model IDs 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.
Last modified on May 28, 2026