Cotar geração LoRA

tong_lora_quote

Obtenha uma cotação para o modelo, entradas e configuração exatos antes de enviar a ação.

POST/v1/tools/tong_lora_quote/operations

Exemplo de solicitação#

curl -X POST 'https://platform.tongai.io/v1/tools/tong_lora_quote/operations' \  -H "Authorization: Bearer $TONG_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03" \  -d '{  "input": {    "body": {      "model": "aaaa",      "prompt": "aaaa",      "loras": [        {          "versionId": "aaaaaaaaaaaaaaaaaaaaaaaa",          "scale": -1        }      ]    }  }}'

Configuração

curl --version

Permissões#

Use uma chave API no servidor para sua conta, ou OAuth para a conta de cada cliente. Nunca envie chaves em prompts ou argumentos.

lora:writequotes:write

Corpo da solicitação#

As solicitações REST envolvem os argumentos em input. As chamadas MCP enviam os mesmos argumentos diretamente.

bodyobjectObrigatório

Mostrar campos aninhados

modelstringObrigatório

Escolha um ID de modelo público Tong da descoberta atual.

Comprimento mínimo: 1 caracteres.

Comprimento máximo: 150 caracteres.

Exemplo"aaaa"

promptstringObrigatório

Descreva o resultado que deseja criar.

Comprimento mínimo: 1 caracteres.

Comprimento máximo: 4000 caracteres.

Exemplo"aaaa"

referenceDirectionobjectOpcional

Mostrar campos aninhados

versionnumberObrigatório

Valores permitidos1

capabilityRevisionstringObrigatório

Comprimento mínimo: 1 caracteres.

Comprimento máximo: 100 caracteres.

keepVideoSoundbooleanOpcional

seedintegerOpcional

Mínimo: 0.

Máximo: 2147483647.

automaticShotsbooleanOpcional

automaticDurationbooleanOpcional

outputResolutionstringOpcional

Valores permitidos"720p-SR""1080p-SR""1440p-SR"

bitratestringOpcional

Valores permitidos"standard""high"

returnLastFramebooleanOpcional

documentUrlstringOpcional

Formato: uri.

Comprimento máximo: 2048 caracteres.

subjectSequenceintegerOpcional

Mínimo: 0.

Máximo: 999.

subjectsobject[]Opcional

Máximo de itens: 6.

Mostrar campos aninhados

idstringObrigatório

Use um rótulo de sujeito numerado, por exemplo Subject1.

namestringObrigatório

Comprimento mínimo: 1 caracteres.

Comprimento máximo: 80 caracteres.

descriptionstringOpcional

Comprimento máximo: 500 caracteres.

assetIdsstring[]Obrigatório

Mínimo de itens: 1.

Máximo de itens: 4.

shotsobject[]Opcional

Mínimo de itens: 1.

Máximo de itens: 6.

Mostrar campos aninhados

idstringObrigatório

Comprimento mínimo: 1 caracteres.

Comprimento máximo: 80 caracteres.

promptstringObrigatório

Descreva o resultado que deseja criar.

Comprimento mínimo: 1 caracteres.

Comprimento máximo: 1800 caracteres.

durationSecondsintegerObrigatório

Mínimo: 1.

Máximo: 15.

referencesobject[]Obrigatório

Use IDs de recursos da sua conta compatíveis com as referências do modelo escolhido.

Máximo de itens: 120.

Mostrar campos aninhados

idstringObrigatório

Comprimento mínimo: 1 caracteres.

Comprimento máximo: 80 caracteres.

assetIdstringObrigatório

Use o identificador de um recurso da conta autorizada.

Um ID hexadecimal de 24 caracteres.

fieldstringObrigatório

Comprimento mínimo: 1 caracteres.

Comprimento máximo: 80 caracteres.

labelstringObrigatório

Use um rótulo de referência numerado, por exemplo Image1.

aspectstringOpcional

Valores permitidos"1:1""16:9""9:16""4:3""3:4"

durationintegerOpcional

Mínimo: 1.

Máximo: 5.

imageIdstringOpcional

Um ID hexadecimal de 24 caracteres.

seedintegerOpcional

Mínimo: 0.

Máximo: 2147483647.

negativePromptstringOpcional

Comprimento máximo: 2000 caracteres.

optionsobjectOpcional

mediaobjectOpcional

presetsobject[]Opcional

Máximo de itens: 3.

Mostrar campos aninhados

keystringObrigatório

Comprimento mínimo: 1 caracteres.

Comprimento máximo: 80 caracteres.

scalenumberObrigatório

Mínimo: 0.

Máximo: 4.

lorasobject[]Obrigatório

Máximo de itens: 9.

Mostrar campos aninhados

versionIdstringObrigatório

Um ID hexadecimal de 24 caracteres.

Exemplo"aaaaaaaaaaaaaaaaaaaaaaaa"

scalenumberObrigatório

Mínimo: -1.

Máximo: 4.

Exemplo-1

rolestringOpcional

Valores permitidos"style""high""low"

Cabeçalhos da solicitação#

HTTP

Authorization: Bearer $TONG_API_KEYContent-Type: application/jsonIdempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03

Mantenha um UUID por ação e reutilize após timeout ou nova tentativa. Entradas diferentes com o mesmo UUID são rejeitadas.

Campos de resposta#

Uma solicitação aceita não é uma geração concluída. Acompanhe o trabalho até o resultado estar pronto.

Resposta

Aceita significa que a solicitação foi salva. Consulte a operação para acompanhar a execução.

JSON

{  "id": "e8aa0a87-6cd9-42eb-975a-b72bf43218c8",  "tool": "tong_lora_quote",  "category": "lora",  "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"  }}

idstringObrigatório

O ID exclusivo da operação salva.

Um UUID, por exemplo e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

toolstringObrigatório

categorystringObrigatório

channelstringObrigatório

Valores permitidos"api""mcp"

statestringObrigatório

O estado atual de execução do trabalho salvo.

Valores permitidos"queued""running""waiting""needs_review""paused""reconciling""succeeded""failed""cancelled"

statusstringObrigatório

O status geral para acompanhar a operação.

Valores permitidos"accepted""running""needs_review""paused""reconciling""succeeded""failed""cancelled"

stagestringObrigatório

A fase atual da operação.

Valores permitidos"admission""dispatch""review""generation""reconciliation""complete"

dispatch_statusstringObrigatório

Indica se a ferramenta aceitou a solicitação. A confirmação não significa que a geração terminou.

Valores permitidos"pending""unknown""acknowledged"

created_atstringObrigatório

Data e hora ISO 8601, por exemplo 2026-10-22T09:00:00Z.

updated_atstringObrigatório

Data e hora ISO 8601, por exemplo 2026-10-22T09:00:00Z.

detail_expires_atstring | nullObrigatório

Quando os detalhes salvos expiram. O valor null indica que não há expiração definida.

Data e hora ISO 8601, por exemplo 2026-10-22T09:00:00Z.

detail_expiredbooleanObrigatório

Indica se os detalhes salvos da operação expiraram.

timingobjectObrigatório

Datas e durações para acompanhar esta operação.

Mostrar campos aninhados

dispatch_started_atstring | nullObrigatório

Data e hora ISO 8601, por exemplo 2026-10-22T09:00:00Z.

acknowledged_atstring | nullObrigatório

Data e hora ISO 8601, por exemplo 2026-10-22T09:00:00Z.

completed_atstring | nullObrigatório

Data e hora ISO 8601, por exemplo 2026-10-22T09:00:00Z.

dispatch_acknowledgement_msnumber | nullObrigatório

Mínimo: 0.

end_to_end_msnumber | nullObrigatório

Mínimo: 0.

reviewJSON | nullObrigatório

Informações de revisão quando a operação exige intervenção humana; caso contrário, null.

resultJSON | nullObrigatório

A saída desta ferramenta, ou null enquanto não houver saída disponível.

errorobject | nullObrigatório

O código de erro público se a operação falhou; caso contrário, null.

Mostrar campos aninhados

codestringObrigatório

billingobjectObrigatório

Uso de créditos e cobranças da carteira. A disponibilidade da saída e a liquidação são independentes.

Mostrar campos aninhados

statusstringObrigatório

Valores permitidos"none""pending""settled""released""reconciling"

usage_creditsstringObrigatório

Uma string decimal com seis casas decimais, por exemplo 1.250000.

wallet_debited_creditsstringObrigatório

Uma string decimal com seis casas decimais, por exemplo 1.250000.

released_creditsstringOpcional

Uma string decimal com seis casas decimais, por exemplo 1.250000.

refunded_creditsstringOpcional

Uma string decimal com seis casas decimais, por exemplo 1.250000.

unfunded_creditsstringOpcional

Uma string decimal com seis casas decimais, por exemplo 1.250000.

pending_creditsstringOpcional

Uma string decimal com seis casas decimais, por exemplo 1.250000.

tokensobjectOpcional

Mostrar campos aninhados

inputnumberOpcional

Mínimo: 0.

outputnumberOpcional

Mínimo: 0.

cachednumberOpcional

Mínimo: 0.

cache_writenumberOpcional

Mínimo: 0.

componentsobject[]Opcional

Mostrar campos aninhados

idstringOpcional

source_idstringObrigatório

toolstringObrigatório

modelstring | nullObrigatório

channelstringObrigatório

Valores permitidos"api""mcp"

credential_idstringObrigatório

kindstringObrigatório

Valores permitidos"text_pool""reasoning""generation"

usage_creditsstringObrigatório

Uma string decimal com seis casas decimais, por exemplo 1.250000.

wallet_debited_creditsstringObrigatório

Uma string decimal com seis casas decimais, por exemplo 1.250000.

evidence_atstringOpcional

Data e hora ISO 8601, por exemplo 2026-10-22T09:00:00Z.

updated_atstringOpcional

Data e hora ISO 8601, por exemplo 2026-10-22T09:00:00Z.

quoteobjectOpcional

A configuração, o preço e os valores de envio quando há uma cotação.

Mostrar campos aninhados

idstringObrigatório

Um UUID, por exemplo e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

operation_idstringObrigatório

Um UUID, por exemplo e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

toolstringObrigatório

operationstring | nullObrigatório

modelstring | nullObrigatório

configurationobjectObrigatório

submit_valuestringObrigatório

submit_fieldstringObrigatório

quoted_creditsstring | nullObrigatório

Uma string decimal com seis casas decimais, por exemplo 1.250000.

expires_atstring | nullObrigatório

Data e hora ISO 8601, por exemplo 2026-10-22T09:00:00Z.

Solicitações e registrosUma solicitação aceita não é uma geração concluída. Acompanhe o trabalho até o resultado estar pronto.Créditos e cobrançaAcompanhe os preços cotados, o uso real e os créditos liquidados.

Chamada MCP#

JSON

{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "tong_lora_quote",    "arguments": {      "body": {        "model": "aaaa",        "prompt": "aaaa",        "loras": [          {            "versionId": "aaaaaaaaaaaaaaaaaaaaaaaa",            "scale": -1          }        ]      }    },    "_meta": {      "io.tongai/idempotency-key": "45be69f1-c266-4a09-a82c-bf3c6303eb03"    }  }}

As solicitações REST envolvem os argumentos em input. As chamadas MCP enviam os mesmos argumentos diretamente.

Resposta

JSON

{  "jsonrpc": "2.0",  "id": 1,  "result": {    "structuredContent": {      "id": "e8aa0a87-6cd9-42eb-975a-b72bf43218c8",      "tool": "tong_lora_quote",      "category": "lora",      "channel": "mcp",      "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"      }    },    "content": [      {        "type": "text",        "text": "{\"id\":\"e8aa0a87-6cd9-42eb-975a-b72bf43218c8\",\"tool\":\"tong_lora_quote\",\"category\":\"lora\",\"channel\":\"mcp\",\"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\"}}"      }    ]  }}

Erros e limites#

HTTP	Erro	Recuperação
`400`	Solicitação inválida`REQUEST_INVALID`	Corrija os campos indicados pelo erro antes de tentar novamente.
`401`	Credencial inválida`CREDENTIAL_INVALID`	Verifique a credencial, a validade e se foi revogada.
`402`	Créditos insuficientes`INSUFFICIENT_CREDITS`	Adicione créditos à conta da credencial e continue o trabalho salvo.
`403`	Permissão negada`SCOPE_REQUIRED`	Use uma credencial com os escopos necessários e acesso ao recurso selecionado.
`404`	Recurso indisponível`RESOURCE_UNAVAILABLE`	Verifique o ID do recurso e se pertence à conta autorizada.
`409`	Conflito de intenção`IDEMPOTENCY_CONFLICT`	Reutilize uma intenção apenas com a solicitação original. Use um novo UUID para outra ação.
`429`	Limite de requisições atingido`RATE_LIMITED`	Aguarde o prazo de Retry-After antes de repetir a mesma solicitação.
`503`	Temporariamente indisponível`DEPENDENCY_UNAVAILABLE`	Aguarde Retry-After e repita com a mesma intenção. Verifique a operação salva após um tempo limite.

Erros e limites de requisiçõesEntenda os erros, tente novamente com segurança e recupere gerações com falha.IdempotênciaMantenha um UUID por ação e reutilize após timeout ou nova tentativa. Entradas diferentes com o mesmo UUID são rejeitadas.

Enviar geração LoRAEnvie a ação configurada usando sua conta e créditos Tong. Acompanhe a operação salva até terminar.Obter tarefa LoRAConsulte o recurso da sua conta ou o estado do fluxo sem iniciar uma geração.Catálogo LoRAConsulte os modelos, ajustes e requisitos de entrada antes de escolher uma configuração.Listar tarefas LoRAConsulte o recurso da sua conta ou o estado do fluxo sem iniciar uma geração.Obter referência LoRAConsulte o recurso da sua conta ou o estado do fluxo sem iniciar uma geração.Obter imagem LoRAConsulte o recurso da sua conta ou o estado do fluxo sem iniciar uma geração.

Cotar geração LoRA

Exemplo de solicitação#

Permissões#

Corpo da solicitação#

Cabeçalhos da solicitação#

Campos de resposta#

Chamada MCP#

Resposta

Erros e limites#

Ferramentas relacionadas#