`POST /v1/text/responses`

Используйте описанные поля и разрешения для этого эндпоинта HTTP.

Пример запроса#

curl -X POST 'https://platform.tongai.io/v1/text/responses' \  -H "Authorization: Bearer $TONG_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03" \  -d '{  "quote_id": "example"}'

Настройки

curl --version

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

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

text:writecredits:spend

Параметры#

Idempotency-KeystringОбязательно

UUID, например e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

Тело запроса#

application/json

quote_idstringОбязательно

Используйте буквы, цифры или дефисы.

Минимальная длина: 1 символов.

Максимальная длина: 120 символов.

Схема ответа#

Ответ

JSON

{  "id": "e8aa0a87-6cd9-42eb-975a-b72bf43218c8",  "tool": "example",  "category": "example",  "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": "2026-10-22T09:00:00.000Z",  "detail_expired": false,  "timing": {    "dispatch_started_at": "2026-10-22T09:00:00.000Z",    "acknowledged_at": "2026-10-22T09:00:00.000Z",    "completed_at": "2026-10-22T09:00:00.000Z",    "dispatch_acknowledgement_ms": 0,    "end_to_end_ms": 0  },  "review": null,  "result": null,  "error": {    "code": "example"  },  "billing": {    "status": "none",    "usage_credits": "0.000000",    "wallet_debited_credits": "0.000000"  }}

`HTTP 202`

application/json

idstringОбязательно

Уникальный ID сохранённой операции.

UUID, например e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

toolstringОбязательно

categorystringОбязательно

channelstringОбязательно

Допустимые значения"api""mcp"

statestringОбязательно

Текущее состояние выполнения сохранённой работы.

Допустимые значения"queued""running""waiting""needs_review""paused""reconciling""succeeded""failed""cancelled"

statusstringОбязательно

Общий статус для отслеживания операции.

Допустимые значения"accepted""running""needs_review""paused""reconciling""succeeded""failed""cancelled"

stagestringОбязательно

Текущий этап операции.

Допустимые значения"admission""dispatch""review""generation""reconciliation""complete"

dispatch_statusstringОбязательно

Принял ли инструмент запрос. Подтверждение не означает завершение генерации.

Допустимые значения"pending""unknown""acknowledged"

created_atstringОбязательно

Дата и время в формате ISO 8601, например 2026-10-22T09:00:00Z.

updated_atstringОбязательно

Дата и время в формате ISO 8601, например 2026-10-22T09:00:00Z.

detail_expires_atstring | nullОбязательно

Срок хранения деталей операции. null означает, что срок пока не задан.

Дата и время в формате ISO 8601, например 2026-10-22T09:00:00Z.

detail_expiredbooleanОбязательно

Истёк ли срок хранения деталей операции.

timingobjectОбязательно

Метки времени и длительности для отслеживания операции.

Показать вложенные поля

dispatch_started_atstring | nullОбязательно

Дата и время в формате ISO 8601, например 2026-10-22T09:00:00Z.

acknowledged_atstring | nullОбязательно

Дата и время в формате ISO 8601, например 2026-10-22T09:00:00Z.

completed_atstring | nullОбязательно

Дата и время в формате ISO 8601, например 2026-10-22T09:00:00Z.

dispatch_acknowledgement_msnumber | nullОбязательно

Минимум: 0.

end_to_end_msnumber | nullОбязательно

Минимум: 0.

reviewJSON | nullОбязательно

Данные проверки, если нужно участие человека; иначе null.

resultJSON | nullОбязательно

Результат инструмента или null, пока результата нет.

errorobject | nullОбязательно

Публичный код ошибки при сбое операции; иначе null.

Показать вложенные поля

codestringОбязательно

billingobjectОбязательно

Расход кредитов и списания кошелька. Готовность результата и окончательный расчёт учитываются отдельно.

Показать вложенные поля

statusstringОбязательно

Допустимые значения"none""pending""settled""released""reconciling"

usage_creditsstringОбязательно

Десятичная строка с шестью знаками после точки, например 1.250000.

wallet_debited_creditsstringОбязательно

Десятичная строка с шестью знаками после точки, например 1.250000.

released_creditsstringНеобязательно

Десятичная строка с шестью знаками после точки, например 1.250000.

refunded_creditsstringНеобязательно

Десятичная строка с шестью знаками после точки, например 1.250000.

unfunded_creditsstringНеобязательно

Десятичная строка с шестью знаками после точки, например 1.250000.

pending_creditsstringНеобязательно

Десятичная строка с шестью знаками после точки, например 1.250000.

tokensobjectНеобязательно

Показать вложенные поля

inputnumberНеобязательно

Минимум: 0.

outputnumberНеобязательно

Минимум: 0.

cachednumberНеобязательно

Минимум: 0.

cache_writenumberНеобязательно

Минимум: 0.

componentsobject[]Необязательно

Показать вложенные поля

idstringНеобязательно

source_idstringОбязательно

toolstringОбязательно

modelstring | nullОбязательно

channelstringОбязательно

Допустимые значения"api""mcp"

credential_idstringОбязательно

kindstringОбязательно

Допустимые значения"text_pool""reasoning""generation"

usage_creditsstringОбязательно

Десятичная строка с шестью знаками после точки, например 1.250000.

wallet_debited_creditsstringОбязательно

Десятичная строка с шестью знаками после точки, например 1.250000.

evidence_atstringНеобязательно

Дата и время в формате ISO 8601, например 2026-10-22T09:00:00Z.

updated_atstringНеобязательно

Дата и время в формате ISO 8601, например 2026-10-22T09:00:00Z.

quoteobjectНеобязательно

Настройки, цена и значения для отправки при наличии расчёта стоимости.

Показать вложенные поля

idstringОбязательно

UUID, например e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

operation_idstringОбязательно

UUID, например e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

toolstringОбязательно

operationstring | nullОбязательно

modelstring | nullОбязательно

configurationobjectОбязательно

submit_valuestringОбязательно

submit_fieldstringОбязательно

quoted_creditsstring | nullОбязательно

Десятичная строка с шестью знаками после точки, например 1.250000.

expires_atstring | nullОбязательно

Дата и время в формате ISO 8601, например 2026-10-22T09:00:00Z.

Ошибки и ограничения#

HTTP	Ошибка	Восстановление
`400`	Недопустимый запрос`REQUEST_INVALID`	Перед повтором исправьте поля, указанные в ошибке.
`401`	Недействительные учётные данные`CREDENTIAL_INVALID`	Проверьте учётные данные, срок действия и отзыв доступа.
`402`	Недостаточно кредитов`INSUFFICIENT_CREDITS`	Пополните кредиты аккаунта, которому принадлежат учётные данные, и продолжите сохранённую работу.
`403`	Доступ запрещён`SCOPE_REQUIRED`	Используйте учётные данные с нужными разрешениями и доступом к выбранному ресурсу.
`404`	Ресурс недоступен`RESOURCE_UNAVAILABLE`	Проверьте ID ресурса и его принадлежность авторизованному аккаунту.
`409`	Конфликт намерений`IDEMPOTENCY_CONFLICT`	Повторно используйте намерение только с исходным запросом. Для другого действия создайте новый UUID.
`429`	Превышен лимит частоты`RATE_LIMITED`	Подождите время из Retry-After, прежде чем повторить тот же запрос.
`503`	Временно недоступно`DEPENDENCY_UNAVAILABLE`	Выждите Retry-After и повторите с тем же намерением. После тайм-аута проверьте сохранённую операцию.

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