Calling the Sume API from Kotlin: no SDK, so write the poll loop

There is no official Kotlin client for the Sume API. The only published SDK is @sume-com/sdk for TypeScript, and the Sume docs say a Kotlin integration with OkHttp or Ktor follows the same three steps as any HTTP client. Hand-written is fine because the contract is small: submit with an idempotency key, poll status, fetch the result.

The three steps

The docs mark their Kotlin snippet as an illustrative sketch, not a package. Treat the steps as the contract.

Deadlines belong to the client

wait_timeout_seconds never exceeds 30 and bounds one HTTP request, not the job. Pick your own overall deadline; the docs call 20 minutes reasonable for video. Sleep next_poll_after_seconds when present and use exponential backoff otherwise. When your deadline passes, the job keeps running and billing, so persist the job id and either resume later from status_url or call cancel.

Typed models

Generate your data classes from the live OpenAPI at https://api.sume.com/reference/json rather than copying field tables from the docs; the docs themselves say the schema is the source of truth. Send exactly one credential header, either x-api-key or Authorization: Bearer, because sending both returns 401.