Schnellstart

API-Schlüssel erstellen, Modell finden, Anfrage kalkulieren und Ergebnis verfolgen.

1. API-Schlüssel erstellen#

Erstellen Sie einen Schlüssel für Ihren Server. Berechtigungen gelten für das zugehörige Konto.

Bewahren Sie Schlüssel auf Ihrem Server auf. Beginnen Sie mit Leserechten und ergänzen Sie nur benötigte Rechte.

BASH

export TONG_API_KEY="YOUR_TONG_API_KEY"

Kostenpflichtige Tools benötigen auch credits:spend. Löschrechte werden separat vergeben.

2. Modell entdecken#

Ersetze Modell-IDs, Referenzfelder und Funktionsrevisionen der Beispiele durch aktuelle Katalogwerte. Die Unterstützung hängt vom Modell und Workflow ab.

curl -X POST 'https://platform.tongai.io/v1/tools/tong_workflows/operations' \  -H "Authorization: Bearer $TONG_API_KEY" \  -H "Content-Type: application/json" \  -d '{  "input": {    "query": {      "operation": "TEXT_TO_VIDEO"    }  }}'

Konfiguration

curl --version

ModellkatalogVerfügbare Modelle, Funktionen und unterstützte Einstellungen entdecken.ModellrichtlinienVor der Integration die veröffentlichte Moderationsrichtlinie jedes Modells prüfen.

3. Konfiguration kalkulieren#

Zuerst Preis abfragen, dann exakt das angebotene Modell und die Konfiguration senden. Den Vorgang bis zum Erfolg, Fehler oder zur Freigabe abfragen.

curl -X POST 'https://platform.tongai.io/v1/tools/tong_generation_quote/operations' \  -H "Authorization: Bearer $TONG_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03" \  -d '{  "input": {    "body": {      "operation": "TEXT_TO_IMAGE",      "model": "tong_ea55aff4f3b5c8aba3a35569",      "routingParameters": {        "ratio": "16:9"      }    }  }}'

Konfiguration

curl --version

Den für genau diese Konfiguration zurückgegebenen Angebotswert zum Absenden verwenden.

Generierung kalkulierenVor dem Absenden die genauen Modelle, Eingaben und Einstellungen kalkulieren lassen.

4. Anfrage absenden#

Die Beispiele verwenden den öffentlichen Endpunkt. Ersetze Beispiel-IDs durch deine eigenen.

curl -X POST 'https://platform.tongai.io/v1/tools/tong_generation_submit/operations' \  -H "Authorization: Bearer $TONG_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03" \  -d '{  "input": {    "params": {      "id": "000000000000000000000001"    },    "body": {      "quoteId": "fixture-image-quote-token",      "prompt": "A quiet street at blue hour",      "operation": "TEXT_TO_IMAGE",      "inputAssetIds": [],      "parameters": {        "textToImageModel": "tong_ea55aff4f3b5c8aba3a35569",        "ratio": "16:9"      }    }  }}'

Konfiguration

curl --version

Für jede Aktion eine UUID behalten und nach Timeout oder Wiederholung erneut verwenden. Andere Eingaben mit derselben UUID werden abgelehnt.

5. Ergebnis verfolgen#

Eine angenommene Anfrage ist noch keine fertige Generierung. Verfolgen Sie den Job, bis das Ergebnis bereitsteht.

curl 'https://platform.tongai.io/v1/operations/e8aa0a87-6cd9-42eb-975a-b72bf43218c8' \  -H "Authorization: Bearer $TONG_API_KEY"

Konfiguration

curl --version

JSON

{  "id": "e8aa0a87-6cd9-42eb-975a-b72bf43218c8",  "tool": "tong_generation_submit",  "category": "generation",  "channel": "api",  "state": "queued",  "status": "accepted",  "stage": "admission",  "dispatch_status": "pending",  "created_at": "2026-10-22T09:00:00.000Z",  "updated_at": "2026-10-22T09:00:00.000Z",  "detail_expires_at": null,  "detail_expired": false,  "timing": {    "dispatch_started_at": null,    "acknowledged_at": null,    "completed_at": null,    "dispatch_acknowledgement_ms": null,    "end_to_end_ms": null  },  "review": null,  "result": null,  "error": null,  "billing": {    "status": "pending",    "usage_credits": "0.000000",    "wallet_debited_credits": "0.000000"  }}

Anfragen und ProtokolleEine angenommene Anfrage ist noch keine fertige Generierung. Verfolgen Sie den Job, bis das Ergebnis bereitsteht.Fehler und RatenlimitsFehler verstehen, sicher erneut versuchen und fehlgeschlagene Generierungen wiederaufnehmen.Credits und AbrechnungAngebotspreise, tatsächliche Nutzung und abgerechnete Credits verfolgen.