Быстрый старт

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

1. Создайте API-ключ#

Создайте ключ для сервера. Разрешения действуют от имени аккаунта-владельца.

Храните ключи на сервере. Начните с чтения и добавляйте только нужные разрешения.

BASH

export TONG_API_KEY="YOUR_TONG_API_KEY"

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

2. Найдите модель#

Замените ID моделей, поля референсов и версии возможностей в примерах актуальными значениями каталога. Поддержка зависит от модели и процесса.

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

Настройки

curl --version

Каталог моделейУзнайте о доступных моделях, возможностях и поддерживаемых настройках.Политики моделейПеред интеграцией изучите опубликованную политику модерации каждой модели.

3. Рассчитайте стоимость настроек#

Сначала получите цену, затем отправьте точно те же модель и настройки. Проверяйте операцию до успеха, ошибки или запроса проверки.

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

Настройки

curl --version

Используйте значение отправки расчёта, возвращённое для этих точных настроек.

Рассчитать стоимость генерацииПеред отправкой получите расчёт стоимости для точных модели, входных данных и настроек.

4. Отправьте запрос#

Примеры используют публичный адрес API. Замените примерные ID своими.

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

Настройки

curl --version

Сохраняйте один UUID для каждого действия и повторно используйте его после тайм-аута. Другие входные данные с тем же UUID отклоняются.

5. Отслеживайте результат#

Принятый запрос не означает завершённую генерацию. Отслеживайте сохранённое задание до готовности результата.

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

Настройки

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

Запросы и журналыПринятый запрос не означает завершённую генерацию. Отслеживайте сохранённое задание до готовности результата.Ошибки и ограничения частотыИзучите ошибки, безопасно повторяйте запросы и восстанавливайте неудачные генерации.Кредиты и оплатаОтслеживайте расчётную стоимость, фактическое использование и списанные кредиты.