Inicio rápido

Crea una clave API, busca un modelo, cotiza una solicitud y sigue su resultado.

1. Crea una clave API#

Crea una clave para tu servidor. Los permisos se aplican a la cuenta propietaria.

Guarda las claves en tu servidor. Empieza con permisos de lectura y añade solo los necesarios.

BASH

export TONG_API_KEY="YOUR_TONG_API_KEY"

Las herramientas de pago también requieren credits:spend. Los permisos de borrado son independientes.

2. Descubre un modelo#

Sustituye los ID de modelo, los campos de referencia y las revisiones del ejemplo por los valores actuales del catálogo. La compatibilidad depende del modelo y del flujo.

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

Configuración

curl --version

Catálogo de modelosDescubre los modelos disponibles, sus capacidades y configuraciones compatibles.Políticas de modelosRevisa la política de moderación publicada de cada modelo antes de integrarlo.

3. Cotiza la configuración#

Primero cotiza y luego envía el modelo y la configuración exactos. Consulta la operación hasta que termine, falle o requiera revisión.

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

Configuración

curl --version

Usa el valor de envío de la cotización devuelto para esta configuración exacta.

Cotizar generaciónObtén una cotización para el modelo, entradas y configuración exactos antes de enviar la acción.

4. Envía la solicitud#

Los ejemplos usan el endpoint público. Sustituye los ID de ejemplo por los tuyos.

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

Configuración

curl --version

Mantén un UUID por acción y reutilízalo tras un tiempo de espera o reintento. Se rechaza una entrada distinta con el mismo UUID.

5. Sigue el resultado#

Una solicitud aceptada no es una generación terminada. Sigue el trabajo hasta que el resultado esté listo.

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

Configuración

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

Solicitudes y registrosUna solicitud aceptada no es una generación terminada. Sigue el trabajo hasta que el resultado esté listo.Errores y límites de solicitudesComprende los errores, reintenta de forma segura y recupera generaciones fallidas.Créditos y facturaciónSigue los precios cotizados, el uso real y los créditos liquidados.