Soumettre une génération

tong_generation_submit

Soumettez l’action configurée avec votre compte et vos crédits Tong. Suivez l’opération enregistrée jusqu’à sa fin.

POST/v1/tools/tong_generation_submit/operations

Exemple de requête#

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

Configuration

curl --version

Autorisations#

Utilisez une clé API côté serveur pour votre compte, ou OAuth pour chaque client. N’envoyez jamais de clés dans les prompts ou arguments.

generation:writecredits:spend

Corps de la requête#

Les requêtes REST placent les arguments dans input. Les appels MCP envoient ces mêmes arguments directement.

paramsobjectObligatoire

Afficher les champs imbriqués

idstringObligatoire

Un identifiant hexadécimal de 24 caractères.

Exemple"000000000000000000000001"

bodyobjectObligatoire

Afficher les champs imbriqués

quoteIdstringObligatoire

Utilisez la valeur de soumission du devis renvoyée pour cette configuration exacte.

Longueur minimale : 1 caractères.

Longueur maximale : 120 caractères.

Exemple"fixture-image-quote-token"

promptstringObligatoire

Décrivez le résultat souhaité.

Longueur minimale : 1 caractères.

Longueur maximale : 5000 caractères.

Exemple"A quiet street at blue hour"

operationstringObligatoire

Sélectionnez un flux pris en charge par le modèle choisi.

Valeurs autorisées"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"

Exemple"TEXT_TO_IMAGE"

inputAssetIdsstring[]Obligatoire

Nombre maximal d’éléments : 120.

Exemple[]

parametersobjectObligatoire

Afficher les champs imbriqués

directorRequiredReferenceCountintegerFacultatif

Minimum : 1.

Maximum : 20.

referenceDirectionobjectFacultatif

Afficher les champs imbriqués

versionnumberObligatoire

Valeurs autorisées1

capabilityRevisionstringObligatoire

Longueur minimale : 1 caractères.

Longueur maximale : 100 caractères.

keepVideoSoundbooleanFacultatif

seedintegerFacultatif

Minimum : 0.

Maximum : 2147483647.

automaticShotsbooleanFacultatif

automaticDurationbooleanFacultatif

outputResolutionstringFacultatif

Valeurs autorisées"720p-SR""1080p-SR""1440p-SR"

bitratestringFacultatif

Valeurs autorisées"standard""high"

returnLastFramebooleanFacultatif

documentUrlstringFacultatif

Format : uri.

Longueur maximale : 2048 caractères.

subjectSequenceintegerFacultatif

Minimum : 0.

Maximum : 999.

subjectsobject[]Facultatif

Nombre maximal d’éléments : 6.

Afficher les champs imbriqués

idstringObligatoire

Utilisez un libellé de sujet numéroté, par exemple Subject1.

namestringObligatoire

Longueur minimale : 1 caractères.

Longueur maximale : 80 caractères.

descriptionstringFacultatif

Longueur maximale : 500 caractères.

assetIdsstring[]Obligatoire

Nombre minimal d’éléments : 1.

Nombre maximal d’éléments : 4.

shotsobject[]Facultatif

Nombre minimal d’éléments : 1.

Nombre maximal d’éléments : 6.

Afficher les champs imbriqués

idstringObligatoire

Longueur minimale : 1 caractères.

Longueur maximale : 80 caractères.

promptstringObligatoire

Décrivez le résultat souhaité.

Longueur minimale : 1 caractères.

Longueur maximale : 1800 caractères.

durationSecondsintegerObligatoire

Minimum : 1.

Maximum : 15.

referencesobject[]Obligatoire

Utilisez les ID de ressources de votre compte compatibles avec les références du modèle choisi.

Nombre maximal d’éléments : 120.

Afficher les champs imbriqués

idstringObligatoire

Longueur minimale : 1 caractères.

Longueur maximale : 80 caractères.

assetIdstringObligatoire

Utilisez l’identifiant d’une ressource du compte autorisé.

Un identifiant hexadécimal de 24 caractères.

fieldstringObligatoire

Longueur minimale : 1 caractères.

Longueur maximale : 80 caractères.

labelstringObligatoire

Utilisez un libellé de référence numéroté, par exemple Image1.

autoEnhancePromptbooleanFacultatif

promptEnhancementIdstringFacultatif

Un identifiant hexadécimal de 24 caractères.

negativePromptModestringFacultatif

Valeurs autorisées"REPLACE"

cameraMotionstringFacultatif

Valeurs autorisées"AUTO""ORBIT_RIGHT""ORBIT_LEFT""PUSH_IN""PULL_BACK""RISE"

qualityPresetstringFacultatif

Valeurs autorisées"REALISTIC""DRAFT"

casualPhoneFinishbooleanFacultatif

recreateReferenceRolesstring[]Facultatif

Nombre minimal d’éléments : 2.

Nombre maximal d’éléments : 20.

characterVideoReferenceRolesstring[]Facultatif

Nombre minimal d’éléments : 1.

Nombre maximal d’éléments : 30.

imageModelstringFacultatif

Longueur minimale : 1 caractères.

Longueur maximale : 150 caractères.

textToImageModelstringFacultatif

Longueur minimale : 1 caractères.

Longueur maximale : 150 caractères.

Exemple"tong_ea55aff4f3b5c8aba3a35569"

videoModelstringFacultatif

Longueur minimale : 1 caractères.

Longueur maximale : 150 caractères.

durationSecondsintegerFacultatif

Minimum : 2.

Maximum : 30.

resolutionstringFacultatif

Valeurs autorisées"480p""720p""768p""1080p""2k""4k"

ratiostringFacultatif

Valeurs autorisées"21:9""16:9""4:3""1:1""3:4""9:16""adaptive"

Exemple"16:9"

videoStylestringFacultatif

Valeurs autorisées"NATURAL_PHONE""CINEMATIC""FOLLOW_PROMPT"

generateAudiobooleanFacultatif

seedintegerFacultatif

Minimum : 0.

Maximum : 2147483647.

promptExtendbooleanFacultatif

negativePromptstringFacultatif

Longueur maximale : 2000 caractères.

workspaceProjectIdstring | nullFacultatif

Un identifiant hexadécimal de 24 caractères.

characterProfileIdstringFacultatif

Un identifiant hexadécimal de 24 caractères.

annotationsobject[]Facultatif

Nombre maximal d’éléments : 8.

Afficher les champs imbriqués

xnumberObligatoire

Minimum : 0.

Maximum : 1.

ynumberObligatoire

Minimum : 0.

Maximum : 1.

radiusnumberObligatoire

Minimum : 0.02.

Maximum : 0.5.

commentstringObligatoire

Longueur minimale : 1 caractères.

Longueur maximale : 500 caractères.

filmSceneobjectFacultatif

Afficher les champs imbriqués

projectIdstringObligatoire

Utilisez l’identifiant d’un projet du compte autorisé.

Un identifiant hexadécimal de 24 caractères.

shotIdstringObligatoire

Utilisez des lettres, chiffres, tirets bas ou traits d’union.

Longueur minimale : 1 caractères.

Longueur maximale : 120 caractères.

revisionintegerObligatoire

Minimum : 0.

Maximum : 9007199254740991.

filmReferenceobjectFacultatif

Afficher les champs imbriqués

projectIdstringObligatoire

Utilisez l’identifiant d’un projet du compte autorisé.

Un identifiant hexadécimal de 24 caractères.

entityIdstringObligatoire

Utilisez des lettres, chiffres, tirets bas ou traits d’union.

Longueur minimale : 1 caractères.

Longueur maximale : 120 caractères.

revisionintegerObligatoire

Minimum : 0.

Maximum : 9007199254740991.

En-têtes de requête#

HTTP

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

Conservez un UUID par action et réutilisez-le après un délai ou une nouvelle tentative. Une entrée différente avec le même UUID est refusée.

Champs de réponse#

Une requête acceptée n’est pas une génération terminée. Suivez le travail jusqu’à ce que le résultat soit prêt.

Réponse

Acceptée signifie que la requête a été enregistrée. Consultez l’opération pour suivre son exécution.

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

idstringObligatoire

L’identifiant unique de l’opération enregistrée.

Un UUID, par exemple e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

toolstringObligatoire

categorystringObligatoire

channelstringObligatoire

Valeurs autorisées"api""mcp"

statestringObligatoire

L’état d’exécution actuel du travail enregistré.

Valeurs autorisées"queued""running""waiting""needs_review""paused""reconciling""succeeded""failed""cancelled"

statusstringObligatoire

Le statut global à utiliser pour suivre l’opération.

Valeurs autorisées"accepted""running""needs_review""paused""reconciling""succeeded""failed""cancelled"

stagestringObligatoire

La phase actuelle de l’opération.

Valeurs autorisées"admission""dispatch""review""generation""reconciliation""complete"

dispatch_statusstringObligatoire

Indique si l’outil a accepté la requête. Un accusé de réception ne signifie pas que la génération est terminée.

Valeurs autorisées"pending""unknown""acknowledged"

created_atstringObligatoire

Date et heure ISO 8601, par exemple 2026-10-22T09:00:00Z.

updated_atstringObligatoire

Date et heure ISO 8601, par exemple 2026-10-22T09:00:00Z.

detail_expires_atstring | nullObligatoire

Date d’expiration des détails enregistrés. La valeur null indique qu’aucune expiration n’est définie.

Date et heure ISO 8601, par exemple 2026-10-22T09:00:00Z.

detail_expiredbooleanObligatoire

Indique si les détails enregistrés ont expiré.

timingobjectObligatoire

Horodatages et durées pour suivre cette opération.

Afficher les champs imbriqués

dispatch_started_atstring | nullObligatoire

Date et heure ISO 8601, par exemple 2026-10-22T09:00:00Z.

acknowledged_atstring | nullObligatoire

Date et heure ISO 8601, par exemple 2026-10-22T09:00:00Z.

completed_atstring | nullObligatoire

Date et heure ISO 8601, par exemple 2026-10-22T09:00:00Z.

dispatch_acknowledgement_msnumber | nullObligatoire

Minimum : 0.

end_to_end_msnumber | nullObligatoire

Minimum : 0.

reviewJSON | nullObligatoire

Informations de validation si une intervention humaine est requise ; sinon null.

resultJSON | nullObligatoire

La sortie de cet outil, ou null si aucune sortie n’est disponible.

errorobject | nullObligatoire

Le code d’erreur public si l’opération a échoué ; sinon null.

Afficher les champs imbriqués

codestringObligatoire

billingobjectObligatoire

Utilisation des crédits et débits du portefeuille. La disponibilité du résultat et le règlement sont distincts.

Afficher les champs imbriqués

statusstringObligatoire

Valeurs autorisées"none""pending""settled""released""reconciling"

usage_creditsstringObligatoire

Une chaîne décimale avec six chiffres après la virgule, par exemple 1.250000.

wallet_debited_creditsstringObligatoire

Une chaîne décimale avec six chiffres après la virgule, par exemple 1.250000.

released_creditsstringFacultatif

Une chaîne décimale avec six chiffres après la virgule, par exemple 1.250000.

refunded_creditsstringFacultatif

Une chaîne décimale avec six chiffres après la virgule, par exemple 1.250000.

unfunded_creditsstringFacultatif

Une chaîne décimale avec six chiffres après la virgule, par exemple 1.250000.

pending_creditsstringFacultatif

Une chaîne décimale avec six chiffres après la virgule, par exemple 1.250000.

tokensobjectFacultatif

Afficher les champs imbriqués

inputnumberFacultatif

Minimum : 0.

outputnumberFacultatif

Minimum : 0.

cachednumberFacultatif

Minimum : 0.

cache_writenumberFacultatif

Minimum : 0.

componentsobject[]Facultatif

Afficher les champs imbriqués

idstringFacultatif

source_idstringObligatoire

toolstringObligatoire

modelstring | nullObligatoire

channelstringObligatoire

Valeurs autorisées"api""mcp"

credential_idstringObligatoire

kindstringObligatoire

Valeurs autorisées"text_pool""reasoning""generation"

usage_creditsstringObligatoire

Une chaîne décimale avec six chiffres après la virgule, par exemple 1.250000.

wallet_debited_creditsstringObligatoire

Une chaîne décimale avec six chiffres après la virgule, par exemple 1.250000.

evidence_atstringFacultatif

Date et heure ISO 8601, par exemple 2026-10-22T09:00:00Z.

updated_atstringFacultatif

Date et heure ISO 8601, par exemple 2026-10-22T09:00:00Z.

quoteobjectFacultatif

La configuration, le prix et les valeurs de soumission lorsqu’un devis est disponible.

Afficher les champs imbriqués

idstringObligatoire

Un UUID, par exemple e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

operation_idstringObligatoire

Un UUID, par exemple e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

toolstringObligatoire

operationstring | nullObligatoire

modelstring | nullObligatoire

configurationobjectObligatoire

submit_valuestringObligatoire

submit_fieldstringObligatoire

quoted_creditsstring | nullObligatoire

Une chaîne décimale avec six chiffres après la virgule, par exemple 1.250000.

expires_atstring | nullObligatoire

Date et heure ISO 8601, par exemple 2026-10-22T09:00:00Z.

Requêtes et journauxUne requête acceptée n’est pas une génération terminée. Suivez le travail jusqu’à ce que le résultat soit prêt.Crédits et facturationSuivez les devis, l’utilisation réelle et les crédits débités après règlement.

Appel MCP#

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

Les requêtes REST placent les arguments dans input. Les appels MCP envoient ces mêmes arguments directement.

Réponse

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

Erreurs et limites#

HTTP	Erreur	Reprise
`400`	Requête invalide`REQUEST_INVALID`	Corrigez les champs indiqués par l’erreur avant de réessayer.
`401`	Identifiant invalide`CREDENTIAL_INVALID`	Vérifiez l’identifiant, son expiration et son éventuelle révocation.
`402`	Crédits insuffisants`INSUFFICIENT_CREDITS`	Ajoutez des crédits au compte de l’identifiant, puis poursuivez le travail enregistré.
`403`	Autorisation refusée`SCOPE_REQUIRED`	Utilisez un identifiant disposant des autorisations requises et de l’accès à la ressource choisie.
`404`	Ressource indisponible`RESOURCE_UNAVAILABLE`	Vérifiez l’ID de la ressource et son appartenance au compte autorisé.
`409`	Conflit d’intention`IDEMPOTENCY_CONFLICT`	Réutilisez une intention uniquement avec sa requête initiale. Utilisez un nouvel UUID pour une autre action.
`429`	Limite de débit atteinte`RATE_LIMITED`	Attendez le délai Retry-After avant de répéter la même requête.
`503`	Temporairement indisponible`DEPENDENCY_UNAVAILABLE`	Attendez Retry-After et réessayez avec la même intention. Vérifiez l’opération enregistrée après un délai dépassé.

Erreurs et limites de débitComprenez les erreurs, réessayez sans risque et reprenez les générations échouées.IdempotenceConservez un UUID par action et réutilisez-le après un délai ou une nouvelle tentative. Une entrée différente avec le même UUID est refusée.

Réutiliser une générationPréparez une source de votre compte pour l’étape suivante de ce flux.Chiffrer une générationObtenez un devis pour le modèle, les entrées et la configuration exacts avant de soumettre l’action.Chiffrer une alternativeObtenez un devis pour le modèle, les entrées et la configuration exacts avant de soumettre l’action.Générer une alternativeSoumettez l’action configurée avec votre compte et vos crédits Tong. Suivez l’opération enregistrée jusqu’à sa fin.Relancer une générationSoumettez l’action configurée avec votre compte et vos crédits Tong. Suivez l’opération enregistrée jusqu’à sa fin.Obtenir le prompt amélioréConsultez la ressource sélectionnée de votre compte ou l’état du flux sans lancer de génération.

Soumettre une génération

Exemple de requête#

Autorisations#

Corps de la requête#

En-têtes de requête#

Champs de réponse#

Appel MCP#

Réponse

Erreurs et limites#

Outils associés#