api.havenagent.ai

Generate a music track. Poll statusUrl, download at resultUrl. SFW only. Submitting VERIFIES your x402 authorization but does not charge you — under settle-on-delivery the completing status poll is the charge point. An unauthenticated request returns 402 with the quote to sign. A verified submit returns 202 with a `jobId`, a `statusUrl` to poll and a `resultUrl` to download from. Submission is idempotent: re-presenting the SAME authorization (say, after you lost the first response to a timeout) does not create a second job and does not charge you twice. That replay answers **200** with the existing job's current status and `replayed: true` — not another 202 — so accept both. Settle from the SAME wallet that submitted. The job is bound to the submitting payer; a completing poll signed by a different wallet is refused with 403 `wallet_mismatch` and can never settle this job. Typical time to a finished artifact is ~60s, but GPU workers scale to zero, so the first request after an idle period can add 2-10 minutes before the job even starts. Poll for up to `pollBudgetSeconds` (900s) rather than giving up early. SFW only. The prompt and any input image are moderated BEFORE the job is enqueued, so a content rejection happens before any charge.

Free while the job is queued or running: returns 200 with a `status` of `queued` or `running`. THIS IS THE CHARGE POINT. Once the artifact is finished and has passed output content screening, this same poll returns 402 with the quote you already agreed to at submit. Pay it and the poll returns 200 `completed`; then download from `resultUrl` for free. You are charged only on delivery — this poll, when it finds your screened artifact ready to download. Jobs that fail, are withheld by content screening, or that you abandon before this poll never settle; once it has been paid, the free `resultUrl` download does not affect the charge. In the rare case a charge lands before the artifact reaches you, keep polling the job rather than paying again — reconciliation completes almost all of these on its own. A job it cannot resolve is worked by a human — report the jobId to abuse@havenagent.ai. Because the 402 here is conditional on a finished artifact, this operation is not declared payable in this document — an unpaid poll of an unfinished job is genuinely free, and an unknown job id returns 404.

Generate an image from text. SFW only. Submitting VERIFIES your x402 authorization but does not charge you — under settle-on-delivery the completing status poll is the charge point. An unauthenticated request returns 402 with the quote to sign. A verified submit returns 202 with a `jobId`, a `statusUrl` to poll and a `resultUrl` to download from. Submission is idempotent: re-presenting the SAME authorization (say, after you lost the first response to a timeout) does not create a second job and does not charge you twice. That replay answers **200** with the existing job's current status and `replayed: true` — not another 202 — so accept both. Settle from the SAME wallet that submitted. The job is bound to the submitting payer; a completing poll signed by a different wallet is refused with 403 `wallet_mismatch` and can never settle this job. Typical time to a finished artifact is ~120s, but GPU workers scale to zero, so the first request after an idle period can add 2-10 minutes before the job even starts. Poll for up to `pollBudgetSeconds` (900s) rather than giving up early. SFW only. The prompt and any input image are moderated BEFORE the job is enqueued, so a content rejection happens before any charge.

Free while the job is queued or running: returns 200 with a `status` of `queued` or `running`. THIS IS THE CHARGE POINT. Once the artifact is finished and has passed output content screening, this same poll returns 402 with the quote you already agreed to at submit. Pay it and the poll returns 200 `completed`; then download from `resultUrl` for free. You are charged only on delivery — this poll, when it finds your screened artifact ready to download. Jobs that fail, are withheld by content screening, or that you abandon before this poll never settle; once it has been paid, the free `resultUrl` download does not affect the charge. In the rare case a charge lands before the artifact reaches you, keep polling the job rather than paying again — reconciliation completes almost all of these on its own. A job it cannot resolve is worked by a human — report the jobId to abuse@havenagent.ai. Because the 402 here is conditional on a finished artifact, this operation is not declared payable in this document — an unpaid poll of an unfinished job is genuinely free, and an unknown job id returns 404.

Edit an image from a text instruction. SFW only. Submitting VERIFIES your x402 authorization but does not charge you — under settle-on-delivery the completing status poll is the charge point. An unauthenticated request returns 402 with the quote to sign. A verified submit returns 202 with a `jobId`, a `statusUrl` to poll and a `resultUrl` to download from. Submission is idempotent: re-presenting the SAME authorization (say, after you lost the first response to a timeout) does not create a second job and does not charge you twice. That replay answers **200** with the existing job's current status and `replayed: true` — not another 202 — so accept both. Settle from the SAME wallet that submitted. The job is bound to the submitting payer; a completing poll signed by a different wallet is refused with 403 `wallet_mismatch` and can never settle this job. Typical time to a finished artifact is ~300s, but GPU workers scale to zero, so the first request after an idle period can add 2-10 minutes before the job even starts. Poll for up to `pollBudgetSeconds` (1200s) rather than giving up early. SFW only. The prompt and any input image are moderated BEFORE the job is enqueued, so a content rejection happens before any charge.

Free while the job is queued or running: returns 200 with a `status` of `queued` or `running`. THIS IS THE CHARGE POINT. Once the artifact is finished and has passed output content screening, this same poll returns 402 with the quote you already agreed to at submit. Pay it and the poll returns 200 `completed`; then download from `resultUrl` for free. You are charged only on delivery — this poll, when it finds your screened artifact ready to download. Jobs that fail, are withheld by content screening, or that you abandon before this poll never settle; once it has been paid, the free `resultUrl` download does not affect the charge. In the rare case a charge lands before the artifact reaches you, keep polling the job rather than paying again — reconciliation completes almost all of these on its own. A job it cannot resolve is worked by a human — report the jobId to abuse@havenagent.ai. Because the 402 here is conditional on a finished artifact, this operation is not declared payable in this document — an unpaid poll of an unfinished job is genuinely free, and an unknown job id returns 404.

Upscale an image 2x or 4x. SFW only. Submitting VERIFIES your x402 authorization but does not charge you — under settle-on-delivery the completing status poll is the charge point. An unauthenticated request returns 402 with the quote to sign. A verified submit returns 202 with a `jobId`, a `statusUrl` to poll and a `resultUrl` to download from. Submission is idempotent: re-presenting the SAME authorization (say, after you lost the first response to a timeout) does not create a second job and does not charge you twice. That replay answers **200** with the existing job's current status and `replayed: true` — not another 202 — so accept both. Settle from the SAME wallet that submitted. The job is bound to the submitting payer; a completing poll signed by a different wallet is refused with 403 `wallet_mismatch` and can never settle this job. Typical time to a finished artifact is ~300s, but GPU workers scale to zero, so the first request after an idle period can add 2-10 minutes before the job even starts. Poll for up to `pollBudgetSeconds` (1200s) rather than giving up early. SFW only. The prompt and any input image are moderated BEFORE the job is enqueued, so a content rejection happens before any charge.

Free while the job is queued or running: returns 200 with a `status` of `queued` or `running`. THIS IS THE CHARGE POINT. Once the artifact is finished and has passed output content screening, this same poll returns 402 with the quote you already agreed to at submit. Pay it and the poll returns 200 `completed`; then download from `resultUrl` for free. You are charged only on delivery — this poll, when it finds your screened artifact ready to download. Jobs that fail, are withheld by content screening, or that you abandon before this poll never settle; once it has been paid, the free `resultUrl` download does not affect the charge. In the rare case a charge lands before the artifact reaches you, keep polling the job rather than paying again — reconciliation completes almost all of these on its own. A job it cannot resolve is worked by a human — report the jobId to abuse@havenagent.ai. Because the 402 here is conditional on a finished artifact, this operation is not declared payable in this document — an unpaid poll of an unfinished job is genuinely free, and an unknown job id returns 404.

Restore a degraded photo (denoise, deblur, dehaze). SFW only. Submitting VERIFIES your x402 authorization but does not charge you — under settle-on-delivery the completing status poll is the charge point. An unauthenticated request returns 402 with the quote to sign. A verified submit returns 202 with a `jobId`, a `statusUrl` to poll and a `resultUrl` to download from. Submission is idempotent: re-presenting the SAME authorization (say, after you lost the first response to a timeout) does not create a second job and does not charge you twice. That replay answers **200** with the existing job's current status and `replayed: true` — not another 202 — so accept both. Settle from the SAME wallet that submitted. The job is bound to the submitting payer; a completing poll signed by a different wallet is refused with 403 `wallet_mismatch` and can never settle this job. Typical time to a finished artifact is ~300s, but GPU workers scale to zero, so the first request after an idle period can add 2-10 minutes before the job even starts. Poll for up to `pollBudgetSeconds` (1200s) rather than giving up early. SFW only. The prompt and any input image are moderated BEFORE the job is enqueued, so a content rejection happens before any charge.

Free while the job is queued or running: returns 200 with a `status` of `queued` or `running`. THIS IS THE CHARGE POINT. Once the artifact is finished and has passed output content screening, this same poll returns 402 with the quote you already agreed to at submit. Pay it and the poll returns 200 `completed`; then download from `resultUrl` for free. You are charged only on delivery — this poll, when it finds your screened artifact ready to download. Jobs that fail, are withheld by content screening, or that you abandon before this poll never settle; once it has been paid, the free `resultUrl` download does not affect the charge. In the rare case a charge lands before the artifact reaches you, keep polling the job rather than paying again — reconciliation completes almost all of these on its own. A job it cannot resolve is worked by a human — report the jobId to abuse@havenagent.ai. Because the 402 here is conditional on a finished artifact, this operation is not declared payable in this document — an unpaid poll of an unfinished job is genuinely free, and an unknown job id returns 404.

Generate a short video from text or an init image, in any aspect ratio (landscape, portrait or square). SFW only. Submitting VERIFIES your x402 authorization but does not charge you — under settle-on-delivery the completing status poll is the charge point. An unauthenticated request returns 402 with the quote to sign. A verified submit returns 202 with a `jobId`, a `statusUrl` to poll and a `resultUrl` to download from. Submission is idempotent: re-presenting the SAME authorization (say, after you lost the first response to a timeout) does not create a second job and does not charge you twice. That replay answers **200** with the existing job's current status and `replayed: true` — not another 202 — so accept both. Settle from the SAME wallet that submitted. The job is bound to the submitting payer; a completing poll signed by a different wallet is refused with 403 `wallet_mismatch` and can never settle this job. Typical time to a finished artifact is ~600s, but GPU workers scale to zero, so the first request after an idle period can add 2-10 minutes before the job even starts. Poll for up to `pollBudgetSeconds` (1800s) rather than giving up early. SFW only. The prompt and any input image are moderated BEFORE the job is enqueued, so a content rejection happens before any charge. Licensed output: submitting accepts the use terms at https://havenagent.ai/terms/terms-of-service, which bind you and anyone you redistribute the output to. Where the delivered file carries an embedded AI-generated disclosure — signalled by `X-Ai-Disclosure-Embedded: true` on the result response — do not strip it. An MP4 layout we cannot rewrite safely is delivered unmodified with that header `false`, and the disclosure travels in the response envelope instead; either way, disclose AI generation wherever you publish it.

Free while the job is queued or running: returns 200 with a `status` of `queued` or `running`. THIS IS THE CHARGE POINT. Once the artifact is finished and has passed output content screening, this same poll returns 402 with the quote you already agreed to at submit. Pay it and the poll returns 200 `completed`; then download from `resultUrl` for free. You are charged only on delivery — this poll, when it finds your screened artifact ready to download. Jobs that fail, are withheld by content screening, or that you abandon before this poll never settle; once it has been paid, the free `resultUrl` download does not affect the charge. In the rare case a charge lands before the artifact reaches you, keep polling the job rather than paying again — reconciliation completes almost all of these on its own. A job it cannot resolve is worked by a human — report the jobId to abuse@havenagent.ai. Because the 402 here is conditional on a finished artifact, this operation is not declared payable in this document — an unpaid poll of an unfinished job is genuinely free, and an unknown job id returns 404.

Generate a short 2K video with a synchronized soundtrack (dialogue, effects, music) from text or an init image. SFW only. Submitting VERIFIES your x402 authorization but does not charge you — under settle-on-delivery the completing status poll is the charge point. An unauthenticated request returns 402 with the quote to sign. A verified submit returns 202 with a `jobId`, a `statusUrl` to poll and a `resultUrl` to download from. Submission is idempotent: re-presenting the SAME authorization (say, after you lost the first response to a timeout) does not create a second job and does not charge you twice. That replay answers **200** with the existing job's current status and `replayed: true` — not another 202 — so accept both. Settle from the SAME wallet that submitted. The job is bound to the submitting payer; a completing poll signed by a different wallet is refused with 403 `wallet_mismatch` and can never settle this job. Typical time to a finished artifact is ~900s, but GPU workers scale to zero, so the first request after an idle period can add 2-10 minutes before the job even starts. Poll for up to `pollBudgetSeconds` (1800s) rather than giving up early. SFW only. The prompt and any input image are moderated BEFORE the job is enqueued, so a content rejection happens before any charge. Licensed output: submitting accepts the use terms at https://havenagent.ai/terms/terms-of-service, which bind you and anyone you redistribute the output to. Where the delivered file carries an embedded AI-generated disclosure — signalled by `X-Ai-Disclosure-Embedded: true` on the result response — do not strip it. An MP4 layout we cannot rewrite safely is delivered unmodified with that header `false`, and the disclosure travels in the response envelope instead; either way, disclose AI generation wherever you publish it.

Free while the job is queued or running: returns 200 with a `status` of `queued` or `running`. THIS IS THE CHARGE POINT. Once the artifact is finished and has passed output content screening, this same poll returns 402 with the quote you already agreed to at submit. Pay it and the poll returns 200 `completed`; then download from `resultUrl` for free. You are charged only on delivery — this poll, when it finds your screened artifact ready to download. Jobs that fail, are withheld by content screening, or that you abandon before this poll never settle; once it has been paid, the free `resultUrl` download does not affect the charge. In the rare case a charge lands before the artifact reaches you, keep polling the job rather than paying again — reconciliation completes almost all of these on its own. A job it cannot resolve is worked by a human — report the jobId to abuse@havenagent.ai. Because the 402 here is conditional on a finished artifact, this operation is not declared payable in this document — an unpaid poll of an unfinished job is genuinely free, and an unknown job id returns 404.