Autenticación

Las claves API cobran a la cuenta propietaria. OAuth permite a cada usuario conectado usar sus créditos.

Claves API#

Usa una clave API en tu servidor para tu cuenta, u OAuth para la cuenta de cada cliente. Nunca envíes claves en instrucciones ni argumentos.

HTTP

Authorization: Bearer $TONG_API_KEY

Inicio rápidoCrea una clave API, busca un modelo, cotiza una solicitud y sigue su resultado.Referencia de herramientasExplora todas las herramientas creativas y sus esquemas de solicitud.

Descubrimiento OAuth#

Las claves API cobran a la cuenta propietaria. OAuth permite a cada usuario conectado usar sus créditos.

curl 'https://platform.tongai.io/.well-known/oauth-authorization-server'

Configuración

curl --version

HTTP

GET /.well-known/oauth-protected-resourceGET /.well-known/oauth-protected-resource/mcp

Autorización y consentimiento#

OAuth usa PKCE S256, una URI de redirección exacta y un recurso distinto para REST o MCP. El consentimiento se completa en Tong. Los tokens de actualización rotan con cada uso.

JSON

{  "response_type": "code",  "client_id": "https://your-app.example/oauth/client.json",  "redirect_uri": "https://your-app.example/oauth/callback",  "resource": "https://platform.tongai.io/mcp",  "scope": "catalog:read operations:read generation:write quotes:write credits:spend",  "code_challenge_method": "S256",  "code_challenge": "BASE64URL_SHA256_OF_VERIFIER",  "state": "RANDOM_SESSION_STATE"}

HTTP

code_expires_in: 60 secondsaccess_token_expires_in: 300 secondsrefresh_token_expires_in: 30 daystoken_endpoint_auth_method: noneclient_id_metadata_document_supported: true

GET /oauth/authorizeOAuth usa PKCE S256, una URI de redirección exacta y un recurso distinto para REST o MCP. El consentimiento se completa en Tong. Los tokens de actualización rotan con cada uso.POST /oauth/tokenOAuth usa PKCE S256, una URI de redirección exacta y un recurso distinto para REST o MCP. El consentimiento se completa en Tong. Los tokens de actualización rotan con cada uso.POST /oauth/revokeOAuth usa PKCE S256, una URI de redirección exacta y un recurso distinto para REST o MCP. El consentimiento se completa en Tong. Los tokens de actualización rotan con cada uso.

Permisos#

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

Referencia de herramientasExplora todas las herramientas creativas y sus esquemas de solicitud.Configurar MCPConecta Tong en tu cliente MCP, autoriza tu cuenta y descubre las herramientas creativas permitidas.