APIs de texto y chat

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, comienza con Chat Completions o Responses; para formatos nativos del proveedor, usa la página correspondiente del proveedor.

Elige una API de texto y chat

Crear una finalización de chat

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

Crear una respuesta del modelo

Usa razonamiento, salida Multimodal y herramientas integradas mediante la API de Responses.

Crear un Message

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

Generar contenido

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

Llamar a un modelo de texto

Usa cualquier model ID con capacidad de texto de la página de Models o del directorio de modelos. Los ejemplos siguientes llaman al endpoint compatible con OpenAI de Chat Completions.

Estos ejemplos usan el marcador de posición your-model-id. Sustitúyelo por un model ID de texto disponible de la página de Models o del directorio de modelos 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"])

const response = await fetch("https://api.cometapi.com/v1/chat/completions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "your-model-id",
    messages: [
      {
        role: "user",
        content: "Write one sentence about CometAPI.",
      },
    ],
  }),
});

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

const result = await response.json();
console.log(result.choices[0].message.content);

curl https://api.cometapi.com/v1/chat/completions \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "messages": [
      {
        "role": "user",
        "content": "Write one sentence about CometAPI."
      }
    ]
  }'

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 ejemplo de modelos

Esta respuesta de ejemplo del catálogo de modelos muestra el contenedor de /api/models y la forma 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

Clave de API faltante o no válida

Envía Authorization: Bearer $COMETAPI_KEY.

URL base incorrecta

Usa https://api.cometapi.com/v1 para solicitudes compatibles con OpenAI.

Tipo de modelo incorrecto

Elige un modelo con capacidad de texto de la página de modelos.

Error de parámetro específico del proveedor

Elimina los campos opcionales y luego vuelve a agregar los campos uno por uno.

Códigos de error y estrategia de reintento

400

No reintentes hasta que se corrija el cuerpo de la solicitud.

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 retroceso exponencial y reduce la concurrencia.

500 or 503

Reintenta con retroceso 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

Página de modelos

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

Directorio de modelos

Explora la disponibilidad y las capacidades de los modelos.

Precios

Consulta los precios antes de llamar a un modelo.

Moderación de contenido

Claves API

Elige una API de texto y chat

Crear una finalización de chat

Crear una respuesta del modelo

Crear un Message

Generar contenido

Llamar a un modelo de texto

Ejemplo de respuesta

Registros de ejemplo de modelos

Errores comunes

Códigos de error y estrategia de reintento

Precios y directorio de modelos

Página de modelos

Directorio de modelos

Precios

​Elige una API de texto y chat

Crear una finalización de chat

Crear una respuesta del modelo

Crear un Message

Generar contenido

​Llamar a un modelo de texto

​Ejemplo de respuesta

​Registros de ejemplo de modelos

​Errores comunes

​Códigos de error y estrategia de reintento

​Precios y directorio de modelos

Página de modelos

Directorio de modelos

Precios

Elige una API de texto y chat

Llamar a un modelo de texto

Ejemplo de respuesta

Registros de ejemplo de modelos

Errores comunes

Códigos de error y estrategia de reintento

Precios y directorio de modelos