Início rápido

Crie uma chave de API, encontre um modelo, cote uma solicitação e acompanhe o resultado.

1. Crie uma chave de API#

Crie uma chave para seu servidor. As permissões se aplicam à conta proprietária.

Mantenha as chaves no servidor. Comece com acesso de leitura e adicione apenas o necessário.

BASH

export TONG_API_KEY="YOUR_TONG_API_KEY"

Ferramentas pagas também exigem credits:spend. Permissões de exclusão são separadas.

2. Descubra um modelo#

Substitua IDs de modelo, campos de referência e revisões dos exemplos pelos valores atuais do catálogo. O suporte varia por modelo e fluxo.

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

Configuração

curl --version

Catálogo de modelosDescubra os modelos disponíveis, seus recursos e configurações compatíveis.Políticas dos modelosRevise a política de moderação publicada de cada modelo antes de integrá-lo.

3. Cote a configuração#

Consulte o preço e envie o modelo e a configuração exatos. Acompanhe a operação até concluir, falhar ou precisar de revisão.

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

Configuração

curl --version

Use o valor de envio da cotação retornado para esta configuração exata.

Cotar geraçãoObtenha uma cotação para o modelo, entradas e configuração exatos antes de enviar a ação.

4. Envie a solicitação#

Os exemplos usam o endpoint público. Substitua os IDs de exemplo pelos seus.

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

Configuração

curl --version

Mantenha um UUID por ação e reutilize após timeout ou nova tentativa. Entradas diferentes com o mesmo UUID são rejeitadas.

5. Acompanhe o resultado#

Uma solicitação aceita não é uma geração concluída. Acompanhe o trabalho até o resultado estar pronto.

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

Configuração

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

Solicitações e registrosUma solicitação aceita não é uma geração concluída. Acompanhe o trabalho até o resultado estar pronto.Erros e limites de requisiçõesEntenda os erros, tente novamente com segurança e recupere gerações com falha.Créditos e cobrançaAcompanhe os preços cotados, o uso real e os créditos liquidados.