Vai al contenuto principale

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 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 corrispondente del provider.

​
Scegli una API di testo

Chat Completions

Invia messaggi di chat compatibili con OpenAI con un array messages.

Responses

Usa ragionamento, output multimodale e strumenti integrati tramite la API Responses.

Anthropic Messages

Chiama workflow Messages compatibili con Claude con campi nativi del provider.

Gemini content generation

Invia richieste native di generazione di contenuti Gemini.

​
Chiamare un modello di testo

Usa qualsiasi model ID con capacità di testo dalla pagina Models o dalla directory dei modelli. Gli esempi 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"])

​
Esempio di risposta

Una risposta riuscita può essere simile a questa. 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 modello

Questa risposta di esempio del catalogo modelli mostra l’involucro /api/models e la forma di un record di modello di testo. Non è un elenco completo di 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

Invia Authorization: Bearer $COMETAPI_KEY.
Usa https://api.cometapi.com/v1 per richieste compatibili con OpenAI.
Scegli un modello con capacità di testo dalla pagina Models.
Rimuovi i campi facoltativi, poi aggiungili di nuovo uno alla volta.

​
Codici di errore e strategia di retry

Non ritentare finché il corpo della richiesta non è stato corretto.
Non ritentare finché la API key non è presente e valida.
Controlla l’URL di base, il path e il model ID prima di ritentare.
Riprova con exponential backoff e riduci la concorrenza.
Riprova con backoff per errori transitori 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

Models page

Leggi come CometAPI espone i model ID nella documentazione.

Model directory

Esplora la disponibilità e le capacità dei modelli.

Pricing

Controlla i prezzi prima di chiamare un modello.
Last modified on May 28, 2026