Treinos
Os cinco passos de um treino, o que cada um precisa a seguir e como as listas chegam em páginas.
Um treino é um dataset sendo preparado (passos 1 a 3) ou, depois que roda, um modelo (passos 4 e 5). Cada um traz step
(1 a 5) e next_action, os mesmos dois campos que o dashboard, a CLI e os assistentes leem, para que qualquer um deles
conduza o fluxo.
{
"kind": "dataset",
"id": "0199f0c4-…",
"name": "tickets de suporte",
"status": "ready",
"step": 2,
"next_action": "structure"
}Próximas ações
next_action | O que significa | O que chamar |
|---|---|---|
upload_files | Faltam arquivos. | PUT de cada arquivo na sua URL, depois POST /v1/datasets/{id}/files/{arquivo}/complete |
wait | Estamos trabalhando nele. | Leia de novo em alguns segundos: GET /v1/datasets/{id} ou GET /v1/models/{id} |
start_over | Não conseguimos ler os dados. | Crie um dataset novo com os arquivos corrigidos |
structure | Os dados foram lidos e mascarados. | POST /v1/datasets/{id}/structure, ou POST /v1/datasets/{id}/suggest para ver decisões antes |
pick_decisions | A agente sugeriu decisões. | POST /v1/datasets/{id}/structure com { "questions": [...] } |
label_examples | Os exemplos separados para o teste precisam de resposta. | GET /v1/datasets/{id}/labels/next, depois POST /v1/datasets/{id}/labels/{tarefa} com { "label": "..." } |
start_training | Pronto para treinar. | GET /v1/encoders, depois POST /v1/datasets/{id}/models com { "encoder": "ts-moberto-150m" } (1 crédito) |
retry | O treino falhou e o crédito voltou. | POST /v1/datasets/{dataset}/models de novo |
download | O modelo está pronto. | GET /v1/models/{id}/download devolve um link válido por 15 minutos, até files_expire_at |
none | Os arquivos do modelo saíram (expiraram, reembolso ou no seu Hugging Face). | Nada: o registro e a auditoria ficam (Retenção) |
expired | Os dados do dataset expiraram. | Envie de novo para treinar (Retenção) |
Começar um treino sem créditos responde 402 com "error": "no_credits".
Páginas
As listas vêm da mais nova para a mais antiga, uma página por vez:
{ "data": [ ... ], "next": "6b3f…" }Passe limit (de 1 a 100, 25 por padrão) e, para a página seguinte, cursor com o último next. Uma página continua igual
enquanto treinos novos chegam no topo. GET /v1/models e GET /v1/datasets também aceitam status (done para modelos
concluídos, ready para datasets estruturados).
curl "https://api.typestrict.ai/v1/models?status=done&limit=10" \
-H "Authorization: Bearer $TYPESTRICT_API_KEY"