Text- und Chat-APIs - CometAPI Documentation

Verwende die Dokumentation zu den CometAPI-Textmodellen, indem du dein Anfrageformat der Seite zuordnest, die es implementiert. Für OpenAI-kompatiblen Chat beginne mit Chat Completions oder Responses; für provider-native Formate verwende die passende Provider-Seite.

Wähle eine Text- und Chat-API

Eine Chat Completion erstellen

Sende OpenAI-kompatible Chat-Nachrichten mit einem messages-Array.

Eine Modellantwort erstellen

Nutze Reasoning, Multimodal-Ausgabe und integrierte Tools über die Responses API.

Eine Message erstellen

Rufe Claude-kompatible Messages-Workflows mit provider-nativen Feldern auf.

Inhalte generieren

Sende native Anfragen zur Gemini-Inhaltserzeugung.

Ein Textmodell aufrufen

Verwende eine beliebige textfähige model ID von der Models-Seite oder aus dem Modellverzeichnis. Die folgenden Beispiele rufen den OpenAI-kompatiblen Chat Completions-Endpunkt auf.

Diese Beispiele verwenden den Platzhalter your-model-id. Ersetze ihn vor dem Ausführen der Anfrage durch eine verfügbare Text-model ID von der Models-Seite oder aus dem Modellverzeichnis.

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

Antwortbeispiel

Eine erfolgreiche Antwort kann wie folgt aussehen. Feldwerte variieren je nach Modell und Anfrage:

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

Beispiel-Modelldatensätze

Diese Beispielantwort des Modellkatalogs zeigt den /api/models-Envelope und die Form eines Textmodell-Datensatzes. Sie ist keine vollständige Modellliste.

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

Häufige Fehler

Fehlender oder ungültiger API-Schlüssel

Sende Authorization: Bearer $COMETAPI_KEY.

Falsche Basis-URL

Verwende https://api.cometapi.com/v1 für OpenAI-kompatible Anfragen.

Falscher Modelltyp

Wähle ein textfähiges Modell auf der Models page aus.

Providerspezifischer Parameterfehler

Entferne optionale Felder und füge sie dann einzeln wieder hinzu.

Fehlercodes und Retry-Strategie

400

Nicht erneut versuchen, bis der Request-Body korrigiert wurde.

401

Nicht erneut versuchen, bis der API-Schlüssel vorhanden und gültig ist.

404

Überprüfe die Basis-URL, den Pfad und die model ID, bevor du es erneut versuchst.

429

Erneut versuchen mit exponentiellem Backoff und die Parallelität reduzieren.

500 or 503

Mit Backoff erneut versuchen bei vorübergehenden Provider- oder Servicefehlern.

Implementierungsmuster findest du unter Error codes and retry strategy und Rate limits and concurrency.

Preise und Modellverzeichnis

Models page

Lies, wie CometAPI model IDs in der Dokumentation verfügbar macht.

Model directory

Durchsuche Modellverfügbarkeit und Fähigkeiten.

Pricing

Prüfe die Preise, bevor du ein Modell aufrufst.

​Wähle eine Text- und Chat-API

Eine Chat Completion erstellen

Eine Modellantwort erstellen

Eine Message erstellen

Inhalte generieren

​Ein Textmodell aufrufen

​Antwortbeispiel

​Beispiel-Modelldatensätze

​Häufige Fehler

​Fehlercodes und Retry-Strategie

​Preise und Modellverzeichnis

Models page

Model directory

Pricing

Wähle eine Text- und Chat-API

Ein Textmodell aufrufen

Antwortbeispiel

Beispiel-Modelldatensätze

Häufige Fehler

Fehlercodes und Retry-Strategie

Preise und Modellverzeichnis