Zum Hauptinhalt springen

Integrationen

Bild-, Video- und ausgewählte Sprachmodelle über eine einheitliche API integrieren.

Nutzen Sie OpenAI-kompatible Aufrufe für Chat und Rollenspiel oder die Task-API für Bilder, Video und Audio. Wählen Sie ein Modell, halten Sie den Schlüssel auf dem Server und folgen Sie dem passenden Einstieg.

Ihr Weg

Ein API-Schlüssel, vier Wege zur Anbindung

Beginnen Sie dort, wo Ihre Arbeit ohnehin stattfindet. Jeder Weg führt zu denselben Modellen zu denselben Preisen.

Schnellstart in 5 Minuten

Ihr erstes Bild in vier Schritten

Erstellen Sie einen Task, merken Sie sich seine ID und holen Sie dann die fertige Datei ab. Dasselbe Muster gilt für jedes Bild-, Video- und Audiomodell.

  1. 01

    Modell wählen

    Aufgabeneignung, Eingaben, Richtlinie, aktuelle Verfügbarkeit und Preis vergleichen.

  2. 02

    Anfrage kopieren

    Ersetzen Sie die Modell-ID und input des Beispiels durch die genauen Felder dieser Modellseite. Übertragen Sie keine Parameter ungeprüft von einem anderen Modell.

  3. 03

    Vom Server senden

    HTTP 202 bedeutet, dass der Task angenommen wurde, nicht dass die Generierung fertig ist. Der Geschäftscode der Antwort bleibt code: 200. Speichern Sie data.taskId sofort; estimatedCost ist der für diesen Task reservierte Betrag.

  4. 04

    Status mit begrenzten Wiederholungen abfragen

    queued und running laufen noch; succeeded, failed und expired sind Endzustände. Brechen Sie bei jedem Endzustand ab, statt nur auf Erfolg zu warten.

curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-8814-render-1" \
  -d '{
    "model": "alibaba/z-image-turbo/text-to-image",
    "input": { "prompt": "A ceramic teapot on a linen cloth, soft window light" }
  }'

alibaba/z-image-turbo/text-to-image ist ein echter Text-zu-Bild-Endpunkt. Verwenden Sie bei einem anderen Medienmodell dessen genaue ID und Schema.

Verzeichnis

Alle Integrationen auf einen Blick

Wählen Sie das Tool, das Sie ohnehin nutzen. Jede Karte öffnet die Einrichtungsanleitung.

Serversicherheit

Drei Dinge, die im Produktivbetrieb sitzen müssen

Diese drei Regeln schützen vor offengelegten Keys, doppelter Abrechnung und verlorenen Tasks. Sie sind die Mindestvoraussetzung vor dem Produktivstart.

API-Schlüssel auf dem Server halten

Legen Sie den Schlüssel nie in Browsercode, Mobile-Bundles, Prompts, Logs oder Agent-Ausgaben offen. Senden Sie Anfragen aus einem Backend unter Ihrer Kontrolle.

Idempotency-Key

Senden Sie bei jedem Create-Request einen stabilen Idempotency-Key. Ist das Netzwerkergebnis unklar, wiederholen Sie dieselbe Arbeit mit demselben Key – so entstehen nie zwei abrechenbare Tasks.

Angenommene Medienaufträge verfolgen

Speichern Sie die taskId und verwenden Sie einen signierten Webhook oder begrenzte Statusabfragen. Ein angenommener Auftrag startet und kann nicht abgebrochen werden. Fehlgeschlagene oder abgelaufene Aufträge werden normalerweise nicht berechnet. Manche Modelle berechnen Inhaltsablehnungen wie auf ihrer Modellseite angegeben; prüfen Sie diese Abrechnungsbedingungen vor dem Absenden.

API-Dokumentation

Die Referenz zu Ihrer Frage öffnen