Аутентификация

API-ключи расходуют кредиты аккаунта-владельца. OAuth позволяет каждому пользователю тратить свои кредиты.

API-ключи#

Используйте серверный API-ключ для своего аккаунта или OAuth для аккаунта каждого клиента. Не передавайте ключи в запросах модели или аргументах инструментов.

HTTP

Authorization: Bearer $TONG_API_KEY

Быстрый стартСоздайте API-ключ, найдите модель, получите расчёт стоимости и отслеживайте результат.Справочник инструментовПросмотрите все творческие инструменты и схемы их запросов.

Обнаружение OAuth#

API-ключи расходуют кредиты аккаунта-владельца. OAuth позволяет каждому пользователю тратить свои кредиты.

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

Настройки

curl --version

HTTP

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

Авторизация и согласие#

OAuth использует S256 PKCE, точный URI перенаправления и отдельный ресурс для REST или MCP. Согласие даётся в Tong. Refresh-токены меняются при каждом использовании.

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 использует S256 PKCE, точный URI перенаправления и отдельный ресурс для REST или MCP. Согласие даётся в Tong. Refresh-токены меняются при каждом использовании.POST /oauth/tokenOAuth использует S256 PKCE, точный URI перенаправления и отдельный ресурс для REST или MCP. Согласие даётся в Tong. Refresh-токены меняются при каждом использовании.POST /oauth/revokeOAuth использует S256 PKCE, точный URI перенаправления и отдельный ресурс для REST или MCP. Согласие даётся в Tong. Refresh-токены меняются при каждом использовании.

Разрешения#

Платным инструментам также требуется credits:spend. Разрешения на удаление назначаются отдельно.

Справочник инструментовПросмотрите все творческие инструменты и схемы их запросов.Настройка MCPПодключите Tong в MCP-клиенте, авторизуйте аккаунт и используйте разрешённые творческие инструменты.