Skip to main content
The SDK throws DreamtuneError with a status. CLI failures exit nonzero and print a redacted error. MCP tools report failures using isError: true.

Persist before submission

Create and save a unique 16–128 character idempotency key for each intended model, tool or compute operation before sending it. Keep the same key and input when recovering an uncertain submission. Reusing a key for changed input is a conflict; using a fresh key can start another paid operation.

Timeouts

Aborting an HTTP request stops the client from waiting. It does not cancel an accepted provider job or terminate a GPU. Retrieve the saved run, refresh a tool receipt where appropriate, or stop compute explicitly.

Unresolved execution

A run that needs reconciliation remains unresolved until its actual upstream state can be verified. Do not treat an unresolved submission as a failed, free operation or repeatedly submit replacements. Keep the saved request information for investigation.