Démarrage rapide

Créez une clé API, trouvez un modèle, chiffrez une requête et suivez son résultat.

1. Créer une clé API#

Créez une clé pour votre serveur. Les autorisations s’appliquent au compte propriétaire.

Gardez les clés sur votre serveur. Commencez en lecture seule et ajoutez uniquement les droits nécessaires.

BASH

export TONG_API_KEY="YOUR_TONG_API_KEY"

Les outils payants nécessitent aussi credits:spend. Les droits de suppression sont distincts.

2. Découvrir un modèle#

Remplacez les identifiants de modèle, champs de référence et révisions des exemples par les valeurs actuelles du catalogue. La prise en charge dépend du modèle et du workflow.

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

Configuration

curl --version

Catalogue de modèlesDécouvrez les modèles disponibles, leurs capacités et configurations prises en charge.Politiques des modèlesConsultez la politique de modération publiée de chaque modèle avant de l’intégrer.

3. Chiffrer la configuration#

Demandez un devis, puis envoyez le modèle et la configuration exacts. Suivez l’opération jusqu’à sa réussite, son échec ou une demande de validation.

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

Configuration

curl --version

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

Chiffrer une générationObtenez un devis pour le modèle, les entrées et la configuration exacts avant de soumettre l’action.

4. Soumettre la requête#

Les exemples utilisent le point d’accès public. Remplacez les identifiants d’exemple par les vôtres.

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

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.

5. Suivre le résultat#

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.

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

Configuration

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

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.Erreurs et limites de débitComprenez les erreurs, réessayez sans risque et reprenez les générations échouées.Crédits et facturationSuivez les devis, l’utilisation réelle et les crédits débités après règlement.