Generierung absenden

tong_generation_submit

Konfigurierte Aktion mit Tong-Konto und Credits absenden. Gespeicherten Vorgang bis zum Abschluss verfolgen.

POST/v1/tools/tong_generation_submit/operations

Anfragebeispiel#

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

Berechtigungen#

API-Schlüssel serverseitig für das eigene Konto verwenden, OAuth für Kundenkonten. Schlüssel nie in Prompts oder Werkzeugargumenten senden.

generation:writecredits:spend

Anfrageinhalt#

REST-Anfragen umschließen die Argumente mit input. MCP-Aufrufe senden dieselben Argumente direkt.

paramsobjectErforderlich

Verschachtelte Felder anzeigen

idstringErforderlich

Eine hexadezimale ID mit 24 Zeichen.

Beispiel"000000000000000000000001"

bodyobjectErforderlich

Verschachtelte Felder anzeigen

quoteIdstringErforderlich

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

Mindestlänge: 1 Zeichen.

Maximale Länge: 120 Zeichen.

Beispiel"fixture-image-quote-token"

promptstringErforderlich

Gewünschtes Ergebnis beschreiben.

Mindestlänge: 1 Zeichen.

Maximale Länge: 5000 Zeichen.

Beispiel"A quiet street at blue hour"

operationstringErforderlich

Vom gewählten Modell unterstützten Ablauf wählen.

Zulässige Werte"TEXT_TO_IMAGE""IMAGE_EDIT""CHARACTER_RECREATE""CHARACTER_RECREATE_SPICY""TEXT_TO_VIDEO""IMAGE_TO_VIDEO""CHARACTER_TO_VIDEO""CHARACTER_TO_VIDEO_SPICY""FIRST_LAST_TO_VIDEO"

Beispiel"TEXT_TO_IMAGE"

inputAssetIdsstring[]Erforderlich

Maximale Anzahl: 120.

Beispiel[]

parametersobjectErforderlich

Verschachtelte Felder anzeigen

directorRequiredReferenceCountintegerOptional

Minimum: 1.

Maximum: 20.

referenceDirectionobjectOptional

Verschachtelte Felder anzeigen

versionnumberErforderlich

Zulässige Werte1

capabilityRevisionstringErforderlich

Mindestlänge: 1 Zeichen.

Maximale Länge: 100 Zeichen.

keepVideoSoundbooleanOptional

seedintegerOptional

Minimum: 0.

Maximum: 2147483647.

automaticShotsbooleanOptional

automaticDurationbooleanOptional

outputResolutionstringOptional

Zulässige Werte"720p-SR""1080p-SR""1440p-SR"

bitratestringOptional

Zulässige Werte"standard""high"

returnLastFramebooleanOptional

documentUrlstringOptional

Format: uri.

Maximale Länge: 2048 Zeichen.

subjectSequenceintegerOptional

Minimum: 0.

Maximum: 999.

subjectsobject[]Optional

Maximale Anzahl: 6.

Verschachtelte Felder anzeigen

idstringErforderlich

Ein nummeriertes Motivlabel verwenden, zum Beispiel Subject1.

namestringErforderlich

Mindestlänge: 1 Zeichen.

Maximale Länge: 80 Zeichen.

descriptionstringOptional

Maximale Länge: 500 Zeichen.

assetIdsstring[]Erforderlich

Mindestanzahl: 1.

Maximale Anzahl: 4.

shotsobject[]Optional

Mindestanzahl: 1.

Maximale Anzahl: 6.

Verschachtelte Felder anzeigen

idstringErforderlich

Mindestlänge: 1 Zeichen.

Maximale Länge: 80 Zeichen.

promptstringErforderlich

Gewünschtes Ergebnis beschreiben.

Mindestlänge: 1 Zeichen.

Maximale Länge: 1800 Zeichen.

durationSecondsintegerErforderlich

Minimum: 1.

Maximum: 15.

referencesobject[]Erforderlich

Eigene Medienkennungen verwenden, die den Referenzfunktionen des gewählten Modells entsprechen.

Maximale Anzahl: 120.

Verschachtelte Felder anzeigen

idstringErforderlich

Mindestlänge: 1 Zeichen.

Maximale Länge: 80 Zeichen.

assetIdstringErforderlich

Kennung eines Mediums des autorisierten Kontos verwenden.

Eine hexadezimale ID mit 24 Zeichen.

fieldstringErforderlich

Mindestlänge: 1 Zeichen.

Maximale Länge: 80 Zeichen.

labelstringErforderlich

Ein nummeriertes Referenzlabel verwenden, zum Beispiel Image1.

autoEnhancePromptbooleanOptional

promptEnhancementIdstringOptional

Eine hexadezimale ID mit 24 Zeichen.

negativePromptModestringOptional

Zulässige Werte"REPLACE"

cameraMotionstringOptional

Zulässige Werte"AUTO""ORBIT_RIGHT""ORBIT_LEFT""PUSH_IN""PULL_BACK""RISE"

qualityPresetstringOptional

Zulässige Werte"REALISTIC""DRAFT"

casualPhoneFinishbooleanOptional

recreateReferenceRolesstring[]Optional

Mindestanzahl: 2.

Maximale Anzahl: 20.

characterVideoReferenceRolesstring[]Optional

Mindestanzahl: 1.

Maximale Anzahl: 30.

imageModelstringOptional

Mindestlänge: 1 Zeichen.

Maximale Länge: 150 Zeichen.

textToImageModelstringOptional

Mindestlänge: 1 Zeichen.

Maximale Länge: 150 Zeichen.

Beispiel"tong_ea55aff4f3b5c8aba3a35569"

videoModelstringOptional

Mindestlänge: 1 Zeichen.

Maximale Länge: 150 Zeichen.

durationSecondsintegerOptional

Minimum: 2.

Maximum: 30.

resolutionstringOptional

Zulässige Werte"480p""720p""768p""1080p""2k""4k"

ratiostringOptional

Zulässige Werte"21:9""16:9""4:3""1:1""3:4""9:16""adaptive"

Beispiel"16:9"

videoStylestringOptional

Zulässige Werte"NATURAL_PHONE""CINEMATIC""FOLLOW_PROMPT"

generateAudiobooleanOptional

seedintegerOptional

Minimum: 0.

Maximum: 2147483647.

promptExtendbooleanOptional

negativePromptstringOptional

Maximale Länge: 2000 Zeichen.

workspaceProjectIdstring | nullOptional

Eine hexadezimale ID mit 24 Zeichen.

characterProfileIdstringOptional

Eine hexadezimale ID mit 24 Zeichen.

annotationsobject[]Optional

Maximale Anzahl: 8.

Verschachtelte Felder anzeigen

xnumberErforderlich

Minimum: 0.

Maximum: 1.

ynumberErforderlich

Minimum: 0.

Maximum: 1.

radiusnumberErforderlich

Minimum: 0.02.

Maximum: 0.5.

commentstringErforderlich

Mindestlänge: 1 Zeichen.

Maximale Länge: 500 Zeichen.

filmSceneobjectOptional

Verschachtelte Felder anzeigen

projectIdstringErforderlich

Kennung eines Projekts des autorisierten Kontos verwenden.

Eine hexadezimale ID mit 24 Zeichen.

shotIdstringErforderlich

Buchstaben, Zahlen, Unterstriche oder Bindestriche verwenden.

Mindestlänge: 1 Zeichen.

Maximale Länge: 120 Zeichen.

revisionintegerErforderlich

Minimum: 0.

Maximum: 9007199254740991.

filmReferenceobjectOptional

Verschachtelte Felder anzeigen

projectIdstringErforderlich

Kennung eines Projekts des autorisierten Kontos verwenden.

Eine hexadezimale ID mit 24 Zeichen.

entityIdstringErforderlich

Buchstaben, Zahlen, Unterstriche oder Bindestriche verwenden.

Mindestlänge: 1 Zeichen.

Maximale Länge: 120 Zeichen.

revisionintegerErforderlich

Minimum: 0.

Maximum: 9007199254740991.

Anfrageheader#

HTTP

Authorization: Bearer $TONG_API_KEYContent-Type: application/jsonIdempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03

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

Antwortfelder#

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

Antwort

Angenommen bedeutet, dass die Anfrage gespeichert wurde. Ausführung über den Vorgang verfolgen.

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

idstringErforderlich

Die eindeutige ID des gespeicherten Vorgangs.

Eine UUID, zum Beispiel e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

toolstringErforderlich

categorystringErforderlich

channelstringErforderlich

Zulässige Werte"api""mcp"

statestringErforderlich

Der aktuelle Ausführungszustand der gespeicherten Arbeit.

Zulässige Werte"queued""running""waiting""needs_review""paused""reconciling""succeeded""failed""cancelled"

statusstringErforderlich

Der Gesamtstatus zur Verfolgung des Vorgangs.

Zulässige Werte"accepted""running""needs_review""paused""reconciling""succeeded""failed""cancelled"

stagestringErforderlich

Die aktuelle Phase des Vorgangs.

Zulässige Werte"admission""dispatch""review""generation""reconciliation""complete"

dispatch_statusstringErforderlich

Ob das Werkzeug die Anfrage angenommen hat. Eine Bestätigung bedeutet nicht, dass die Generierung abgeschlossen ist.

Zulässige Werte"pending""unknown""acknowledged"

created_atstringErforderlich

Datum und Uhrzeit nach ISO 8601, zum Beispiel 2026-10-22T09:00:00Z.

updated_atstringErforderlich

Datum und Uhrzeit nach ISO 8601, zum Beispiel 2026-10-22T09:00:00Z.

detail_expires_atstring | nullErforderlich

Wann gespeicherte Details ablaufen. null bedeutet, dass derzeit kein Ablauf festgelegt ist.

Datum und Uhrzeit nach ISO 8601, zum Beispiel 2026-10-22T09:00:00Z.

detail_expiredbooleanErforderlich

Ob die gespeicherten Vorgangsdetails abgelaufen sind.

timingobjectErforderlich

Zeitstempel und Laufzeiten zur Verfolgung dieses Vorgangs.

Verschachtelte Felder anzeigen

dispatch_started_atstring | nullErforderlich

Datum und Uhrzeit nach ISO 8601, zum Beispiel 2026-10-22T09:00:00Z.

acknowledged_atstring | nullErforderlich

Datum und Uhrzeit nach ISO 8601, zum Beispiel 2026-10-22T09:00:00Z.

completed_atstring | nullErforderlich

Datum und Uhrzeit nach ISO 8601, zum Beispiel 2026-10-22T09:00:00Z.

dispatch_acknowledgement_msnumber | nullErforderlich

Minimum: 0.

end_to_end_msnumber | nullErforderlich

Minimum: 0.

reviewJSON | nullErforderlich

Prüfinformationen, wenn menschliche Eingabe nötig ist; andernfalls null.

resultJSON | nullErforderlich

Die Ausgabe dieses Werkzeugs oder null, solange keine Ausgabe verfügbar ist.

errorobject | nullErforderlich

Der öffentliche Fehlercode bei fehlgeschlagenem Vorgang; andernfalls null.

Verschachtelte Felder anzeigen

codestringErforderlich

billingobjectErforderlich

Credit-Verbrauch und Wallet-Abbuchungen. Ausgabe und endgültige Abrechnung sind getrennt.

Verschachtelte Felder anzeigen

statusstringErforderlich

Zulässige Werte"none""pending""settled""released""reconciling"

usage_creditsstringErforderlich

Eine Dezimalzeichenfolge mit sechs Nachkommastellen, zum Beispiel 1.250000.

wallet_debited_creditsstringErforderlich

Eine Dezimalzeichenfolge mit sechs Nachkommastellen, zum Beispiel 1.250000.

released_creditsstringOptional

Eine Dezimalzeichenfolge mit sechs Nachkommastellen, zum Beispiel 1.250000.

refunded_creditsstringOptional

Eine Dezimalzeichenfolge mit sechs Nachkommastellen, zum Beispiel 1.250000.

unfunded_creditsstringOptional

Eine Dezimalzeichenfolge mit sechs Nachkommastellen, zum Beispiel 1.250000.

pending_creditsstringOptional

Eine Dezimalzeichenfolge mit sechs Nachkommastellen, zum Beispiel 1.250000.

tokensobjectOptional

Verschachtelte Felder anzeigen

inputnumberOptional

Minimum: 0.

outputnumberOptional

Minimum: 0.

cachednumberOptional

Minimum: 0.

cache_writenumberOptional

Minimum: 0.

componentsobject[]Optional

Verschachtelte Felder anzeigen

idstringOptional

source_idstringErforderlich

toolstringErforderlich

modelstring | nullErforderlich

channelstringErforderlich

Zulässige Werte"api""mcp"

credential_idstringErforderlich

kindstringErforderlich

Zulässige Werte"text_pool""reasoning""generation"

usage_creditsstringErforderlich

Eine Dezimalzeichenfolge mit sechs Nachkommastellen, zum Beispiel 1.250000.

wallet_debited_creditsstringErforderlich

Eine Dezimalzeichenfolge mit sechs Nachkommastellen, zum Beispiel 1.250000.

evidence_atstringOptional

Datum und Uhrzeit nach ISO 8601, zum Beispiel 2026-10-22T09:00:00Z.

updated_atstringOptional

Datum und Uhrzeit nach ISO 8601, zum Beispiel 2026-10-22T09:00:00Z.

quoteobjectOptional

Konfiguration, Preis und Übermittlungswerte, wenn ein Angebot verfügbar ist.

Verschachtelte Felder anzeigen

idstringErforderlich

Eine UUID, zum Beispiel e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

operation_idstringErforderlich

Eine UUID, zum Beispiel e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

toolstringErforderlich

operationstring | nullErforderlich

modelstring | nullErforderlich

configurationobjectErforderlich

submit_valuestringErforderlich

submit_fieldstringErforderlich

quoted_creditsstring | nullErforderlich

Eine Dezimalzeichenfolge mit sechs Nachkommastellen, zum Beispiel 1.250000.

expires_atstring | nullErforderlich

Datum und Uhrzeit nach ISO 8601, zum Beispiel 2026-10-22T09:00:00Z.

Anfragen und ProtokolleEine angenommene Anfrage ist noch keine fertige Generierung. Verfolgen Sie den Job, bis das Ergebnis bereitsteht.Credits und AbrechnungAngebotspreise, tatsächliche Nutzung und abgerechnete Credits verfolgen.

MCP-Aufruf#

JSON

{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "tong_generation_submit",    "arguments": {      "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"        }      }    },    "_meta": {      "io.tongai/idempotency-key": "45be69f1-c266-4a09-a82c-bf3c6303eb03"    }  }}

REST-Anfragen umschließen die Argumente mit input. MCP-Aufrufe senden dieselben Argumente direkt.

Antwort

JSON

{  "jsonrpc": "2.0",  "id": 1,  "result": {    "structuredContent": {      "id": "e8aa0a87-6cd9-42eb-975a-b72bf43218c8",      "tool": "tong_generation_submit",      "category": "generation",      "channel": "mcp",      "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"      }    },    "content": [      {        "type": "text",        "text": "{\"id\":\"e8aa0a87-6cd9-42eb-975a-b72bf43218c8\",\"tool\":\"tong_generation_submit\",\"category\":\"generation\",\"channel\":\"mcp\",\"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\"}}"      }    ]  }}

Fehler und Limits#

HTTP	Fehler	Wiederherstellung
`400`	Ungültige Anfrage`REQUEST_INVALID`	Vor dem erneuten Versuch die im Fehler genannten Felder korrigieren.
`401`	Ungültiger Zugangsnachweis`CREDENTIAL_INVALID`	Zugangsnachweis, Ablaufdatum und möglichen Widerruf prüfen.
`402`	Unzureichende Credits`INSUFFICIENT_CREDITS`	Credits dem Konto des Zugangsnachweises hinzufügen, dann gespeicherte Arbeit fortsetzen.
`403`	Zugriff verweigert`SCOPE_REQUIRED`	Zugangsnachweis mit den nötigen Berechtigungen und Ressourcenzugriff verwenden.
`404`	Ressource nicht verfügbar`RESOURCE_UNAVAILABLE`	Ressourcenkennung prüfen und sicherstellen, dass sie zum autorisierten Konto gehört.
`409`	Aktionskonflikt`IDEMPOTENCY_CONFLICT`	Aktionskennung nur für die ursprüngliche Anfrage wiederverwenden. Für eine andere Aktion eine neue UUID verwenden.
`429`	Ratenlimit erreicht`RATE_LIMITED`	Vor Wiederholung derselben Anfrage die Zeit aus Retry-After abwarten.
`503`	Vorübergehend nicht verfügbar`DEPENDENCY_UNAVAILABLE`	Retry-After abwarten und mit derselben Aktionskennung wiederholen. Nach Zeitüberschreitung gespeicherten Vorgang prüfen.

Fehler und RatenlimitsFehler verstehen, sicher erneut versuchen und fehlgeschlagene Generierungen wiederaufnehmen.IdempotenzFür jede Aktion eine UUID behalten und nach Timeout oder Wiederholung erneut verwenden. Andere Eingaben mit derselben UUID werden abgelehnt.

Generierung wiederverwendenEigene Quelle für den nächsten Schritt dieses Ablaufs vorbereiten.Generierung kalkulierenVor dem Absenden die genauen Modelle, Eingaben und Einstellungen kalkulieren lassen.Alternative kalkulierenVor dem Absenden die genauen Modelle, Eingaben und Einstellungen kalkulieren lassen.Alternative generierenKonfigurierte Aktion mit Tong-Konto und Credits absenden. Gespeicherten Vorgang bis zum Abschluss verfolgen.Generierung erneut versuchenKonfigurierte Aktion mit Tong-Konto und Credits absenden. Gespeicherten Vorgang bis zum Abschluss verfolgen.Verbesserten Prompt abrufenGewählte eigene Ressource oder aktuellen Ablaufstatus lesen, ohne eine neue Generierung zu starten.

Generierung absenden

Anfragebeispiel#

Berechtigungen#

Anfrageinhalt#

Anfrageheader#

Antwortfelder#

MCP-Aufruf#

Antwort

Fehler und Limits#

Verwandte Werkzeuge#