API-Spezifikation
Referenz für Integrationen in Text-, Agenten-, Medien- und Abruf-Workflows.
https://cicora.ai/api/v1https://cicora.ai/apiIntegrationsreferenz: Wählen Sie Parameter und verfügbare Funktionen in den API-Einstellungen Ihres Kontos und im Modellkatalog für Ihre Umgebung aus.
Erste Anfrage sendenLoslegen
Senden Sie eine erste Anfrage, wählen Sie ein Modell aus dem Katalog und speichern Sie eine Anfragekennung für die Diagnose.
AuthentifizierungSenden Sie einen API-Schlüssel in einem Bearer-Header und halten Sie Produktionszugangsdaten von Entwicklungszugangsdaten getrennt.
SDKs und HTTP-ClientsVerwenden Sie unterschiedliche Basis-URLs für OpenAI-kompatible Clients und Messages-Clients: Sie zielen auf dieselbe Spezifikation ab, setzen Pfade jedoch unterschiedlich zusammen.
CLI und IntegrationenKonfigurieren Sie einen Client mit einem Schlüssel, einem Modell und einer Basis-URL, die seinem Protokoll entspricht; bewahren Sie das Geheimnis in der Umgebung auf.
FAQ für EntwicklerKurze praktische Antworten zu Schlüsseln, Basis-URLs, Modellen, Kosten und Integrationsdiagnose.
Konto und Katalog
Erstellen Sie die Modellauswahl aus Katalogdaten statt aus einer fest codierten Liste in Ihrer Anwendung.
Teams und API-SchlüsselTrennen Sie Schlüssel, Eigentümer, Budgets und Nutzungsverläufe nach Anwendungen und Arbeitsbereichen.
GrenzwerteBehandeln Sie Grenzwerte für Schlüssel, Organisation, Modell und Routing als Teil des Benutzerarbeitsablaufs.
Nutzung und KostenVerknüpfen Sie Antwortmetadaten und Ihre eigenen Anfrageprotokolle mit tatsächlichen Benutzeraktionen.
Daten und DatenschutzMinimieren Sie übertragene Daten, trennen Sie eine Endbenutzerkennung vom Inhalt und steuern Sie die Aufbewahrung in Ihrem Produkt.
Text und Agenten
Erstellen Sie Unterhaltungen über mehrere Gesprächsrunden im vertrauten messages-Format und wählen Sie für jede Anfrage ein Modell aus.
Messages APIVerwenden Sie für Unterhaltungen das Messages-Format mit einer Systemanweisung auf oberster Ebene und einer ausdrücklichen Ausgabebegrenzung.
Responses APIVerwenden Sie ein Eingabeobjekt, wenn Ihre Anwendung davon profitiert, Ausgabeelemente und Aktionen in einem einzigen Datenmodell zu verarbeiten.
StreamingEmpfangen Sie Token und strukturierte Deltas über SSE, ohne auf die vollständige Antwort zu warten.
Tools und FunktionsaufrufeBeschreiben Sie Funktionen mit JSON Schema, führen Sie den Aufruf in Ihrer Anwendung aus und geben Sie das Ergebnis an die Unterhaltung zurück.
Strukturierte AusgabenFordern Sie ein JSON-Objekt oder ein JSON Schema an, wenn Software statt einer Person die Antwort verarbeitet.
SchlussfolgernLegen Sie den Reasoning-Aufwand pro Anfrage nur für Modelle fest, die diese Funktion angeben.
RoutingDrücken Sie Ausführungsanforderungen in den Anbieterpräferenzen aus und speichern Sie das tatsächliche Ergebnis zur Beobachtbarkeit.
Kontext-CachingTrennen Sie wiederkehrenden Kontext, damit ein Client kompatibles Caching nutzen kann, sofern das gewählte Modell dies unterstützt.
WebsucheRufen Sie aktuelle Quellen über eine vom Client ausgeführte Funktion `web_search` ab und halten Sie Links vom generierten Text getrennt.
Medien und Abruf
Laden Sie eine Datei über einen eigenen Vorgang hoch, speichern Sie ihre ID und übergeben Sie in einer späteren kompatiblen Anfrage einen Verweis.
BilderErstellen Sie Bilder über eine Route und wählen Sie Parameter aus den Funktionen des gewählten Modells aus.
VideoStarten Sie die Videogenerierung als asynchronen Auftrag, speichern Sie die Auftrags-ID und halten Sie Erstellung und Abruf des Ergebnisses getrennt.
AudioVerwenden Sie getrennte Vorgänge für Sprachsynthese, Transkription und Audioeingabe in ein Modell.
EinbettungenWandeln Sie Text oder unterstützte Eingaben in Vektoren für Suche, Clustering und Empfehlungen um.
NeurangordnungOrdnen Sie eine kleine Kandidatengruppe gegenüber einer Abfrage neu an, um die Präzision des endgültigen Abrufs zu erhöhen.
Batch-AusführungVerarbeiten Sie unabhängige Vorgänge in kontrollierten Gruppen, wenn der Arbeitsablauf eine asynchrone Bereitstellung zulässt.