API di testo e chat

Usa la documentazione dei modelli di testo di CometAPI abbinando il formato della tua richiesta alla pagina che lo implementa. Per la chat compatibile con OpenAI, inizia con Chat Completions o Responses; per i formati nativi del provider, usa la pagina del provider corrispondente.

Scegli un’API di testo e chat

Crea un completamento chat

Invia messaggi chat compatibili con OpenAI con un array messages.

Crea una risposta del modello

Usa reasoning, output multimodale e strumenti integrati tramite l’API Responses.

Crea un messaggio

Chiama i flussi di lavoro Messages compatibili con Claude con campi nativi del provider.

Genera contenuti

Invia richieste native di generazione di contenuti Gemini.

Chiama un modello di testo

Usa qualsiasi model ID con capacità di testo dalla pagina Models o dalla directory dei modelli. Gli esempi qui sotto chiamano l’endpoint Chat Completions compatibile con OpenAI.

Questi esempi usano il segnaposto your-model-id. Sostituiscilo con un model ID di testo disponibile dalla pagina Models o dalla directory dei modelli prima di eseguire la richiesta.

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

Esempio di risposta

Una risposta riuscita può apparire così. I valori dei campi variano in base al modello e alla richiesta:

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

Esempi di record di model

Questa risposta di esempio del catalogo modelli mostra l’involucro /api/models e la struttura di un record di modello di testo. Non è un elenco completo dei modelli.

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

Errori comuni

Chiave API mancante o non valida

Invia Authorization: Bearer $COMETAPI_KEY.

URL di base errato

Usa https://api.cometapi.com/v1 per le richieste compatibili con OpenAI.

Tipo di model errato

Scegli un modello con capacità di testo dalla pagina Models.

Errore di parametro specifico del provider

Rimuovi i campi facoltativi, poi riaggiungili uno alla volta.

Codici di errore e strategia di retry

400

Non riprovare finché il corpo della richiesta non è stato corretto.

401

Non riprovare finché la chiave API non è presente e valida.

404

Controlla l’URL di base, il path e il model ID prima di riprovare.

429

Riprova con exponential backoff e riduci la concorrenza.

500 or 503

Riprova con backoff per errori temporanei del provider o del servizio.

Per i pattern di implementazione, vedi Error codes and retry strategy e Rate limits and concurrency.

Prezzi e directory dei modelli

Pagina Models

Leggi come CometAPI espone i model ID nella documentazione.

Directory dei modelli

Esplora disponibilità e capacità dei modelli.

Prezzi

Controlla i prezzi prima di chiamare un modello.

Moderazione dei contenuti

Chiavi API

Scegli un’API di testo e chat

Crea un completamento chat

Crea una risposta del modello

Crea un messaggio

Genera contenuti

Chiama un modello di testo

Esempio di risposta

Esempi di record di model

Errori comuni

Codici di errore e strategia di retry

Prezzi e directory dei modelli

Pagina Models

Directory dei modelli

Prezzi

​Scegli un’API di testo e chat

Crea un completamento chat

Crea una risposta del modello

Crea un messaggio

Genera contenuti

​Chiama un modello di testo

​Esempio di risposta

​Esempi di record di model

​Errori comuni

​Codici di errore e strategia di retry

​Prezzi e directory dei modelli

Pagina Models

Directory dei modelli

Prezzi

Scegli un’API di testo e chat

Chiama un modello di testo

Esempio di risposta

Esempi di record di model

Errori comuni

Codici di errore e strategia di retry

Prezzi e directory dei modelli