Cohere Command-API-Leitfaden

Veröffentlichte Cohere Command-Modelle

Namen, exakte Routing-Kennungen, Versionen und Inferenz-Status stammen, sofern verfügbar, aus der aktivierten Modellregistrierung. Eine leere Kennung bedeutet, dass der Katalog keinen Routing-Wert veröffentlicht hat. Leiten Sie diesen nicht aus dem Modellnamen ab.

Entwickler

Cohere

Zugang für Neukunden

Verfügbar

Ihre erste Anfrage senden

Senden Sie HTTPS-Anfragen an die unten angegebene Basis-URL. Verwenden Sie POST /chat/completions für OpenAI-kompatiblen Textchat oder POST /messages für Claude Messages. Wählen Sie das Protokoll in der Modell-Workbench aus und verwenden Sie die dazugehörige URL und das passende JSON-Format.

API-Basis-URL: https://fusionpointai.com/api/v1

Erstellen oder verwalten Sie einen Kunden-API-Schlüssel in den API-Schlüsseleinstellungen Ihres Kontos. Senden Sie ihn als Bearer-Token und bewahren Sie ihn auf einem vertrauenswürdigen Server auf. Hinterlegen Sie ihn weder im Browsercode noch in der Versionsverwaltung oder in öffentlich zugänglichen Logs.

Der Schlüssel benötigt den Scope ai:inference sowie Zugriff auf das zugehörige Kundenabonnement. Der öffentliche API-Schlüssel ist kein Kontopasswort und darf nicht weitergegeben werden.

Diese Beispiele verwenden den registrierten JSON-Chat-Completions-Endpunkt sowie die OpenAI-kompatiblen Python- und Node.js-Clients. Speichern Sie den Schlüssel in der Umgebungsvariable FUSIONPOINTAI_API_KEY. Ersetzen Sie den Modellwert ausschließlich durch eine der oben aufgeführten exakten Kennungen.

# Install the client for your application language.
# Python:
python -m pip install openai
# Node.js:
npm install openai

# Bash: enter the key without storing it in shell history.
read -rs -p 'FusionPointAI API key: ' FUSIONPOINTAI_API_KEY
export FUSIONPOINTAI_API_KEY
printf '\n'
# After finishing:
# unset FUSIONPOINTAI_API_KEY

curl 'https://fusionpointai.com/api/v1/chat/completions' \
  -H "Authorization: Bearer $FUSIONPOINTAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
    "model": "command-a-plus-05-2026",
    "messages": [
        {
            "role": "user",
            "content": "Summarize this in one sentence."
        }
    ],
    "temperature": 0.7,
    "max_tokens": 300
}'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FUSIONPOINTAI_API_KEY"],
    base_url="https://fusionpointai.com/api/v1",
)

response = client.chat.completions.create(
    model="command-a-plus-05-2026",
    messages=[{"role": "user", "content": "Summarize this in one sentence."}],
    temperature=0.7,
    max_tokens=300,
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.FUSIONPOINTAI_API_KEY,
  baseURL: "https://fusionpointai.com/api/v1",
});

const response = await client.chat.completions.create({
  model: "command-a-plus-05-2026",
  messages: [{ role: "user", content: "Summarize this in one sentence." }],
  temperature: 0.7,
  max_tokens: 300,
});
console.log(response.choices[0].message.content);

OpenAI · Format von Anfrage und Antwort

Der Endpunkt akzeptiert JSON. Nachrichten werden der Reihe nach gesendet; jede Nachricht enthält eine unterstützte Rolle und einen Text als String. Optionale Parameter für die Generierung müssen innerhalb der unten genannten Validierungsgrenzen liegen. Die Antwort ist ein JSON-Objekt vom Typ chat.completion mit choices und, sofern vom Anbieter zurückgegeben, Tokenverbrauch.

Aufbau der Antwort

Eine erfolgreiche Antwort enthält id, object (chat.completion), created, model und choices. Eine Choice enthält ihren Index, eine assistant-Nachricht und finish_reason. Unter usage können Tokenzahlen zurückgegeben werden. Auch wenn eine Anfrage die Gateway-Validierung besteht, können anbieterspezifische Grenzen gelten.

{
    "id": "chatcmpl_example",
    "object": "chat.completion",
    "created": 1700000000,
    "model": "command-a-plus-05-2026",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "A concise summary of the supplied text."
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 12,
        "completion_tokens": 10,
        "total_tokens": 22
    }
}

Zugriff, Grenzen und sicherer Betrieb

Bei aktiven Kundenabonnements werden Anfragen und Token nicht auf ein Kontingent angerechnet; Sandbox-Schlüssel sind auf ihr veröffentlichtes Monatskontingent begrenzt. Diese Angaben zum Abonnement gelten unabhängig von technischen Modell- und Upstream-Grenzen.

• Kontextfenster der Modelle, maximale Ausgabelänge, unterstützte Anfragefunktionen und vorübergehende Upstream-Verkehrsbegrenzungen unterscheiden sich. Prüfen Sie vor produktivem Einsatz die Angaben zum Anbieter und Modell.
• Für den Endpunkt gilt ein Anwendungslimit von 60 Anfragen pro Minute je zutreffender Throttle-Identität. HTTP 429 kann außerdem auf vorübergehende Upstream-Begrenzungen hinweisen. Reduzieren Sie die Frequenz und wiederholen Sie die Anfrage mit wachsendem Abstand statt in einer engen Schleife.
• Verwenden Sie HTTPS, bewahren Sie Schlüssel serverseitig auf, vergeben Sie nur den benötigten Inferenz-Scope und widerrufen Sie einen möglicherweise offengelegten Schlüssel umgehend.
• Chat Completions unterstützt synchronen Text. Claude Messages unterstützt separat native Inhaltsblöcke, Tools und SSE, sofern das ausgewählte Modell diese Funktionen unterstützt. Andere Anbieterendpunkte sind nicht Teil dieser Kontrakte.

Zugriff auf den Anbieter und Kontovoraussetzungen

Authentifizieren Sie sich mit einem Kunden-API-Schlüssel, der den Scope ai:inference besitzt und zu einem Konto mit Zugriff auf diesen Service gehört. Im Katalog sehen Sie, ob Neukunden derzeit zugelassen sind. Der Katalog gewährt keinen Zugriff, richtet kein Abonnement ein und setzt Konto- oder Schlüsselberechtigungen nicht außer Kraft.

Fehler und Fehlerbehebung

Validierungsfehler und unbrauchbare Anbieterantworten des Endpunkts werden als JSON-Fehlerobjekt mit message, type und code ausgegeben. Bei Validierungsfehlern können zusätzlich Feldangaben enthalten sein. Senden Sie keine API-Schlüssel oder vertraulichen Prompt-Inhalte in Supportanfragen.

Validierungs- und Anbieterfehler der Chat-Operation werden in einem Fehlerobjekt zurückgegeben. Authentifizierungs-, Scope- und Throttle-Middleware können stattdessen ein message-Feld auf oberster Ebene ausgeben. Prüfen Sie HTTP-Status und Antwort-Body gemeinsam.

Häufig gestellte Fragen