> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noimosai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hantera körning och debitering

> Asynkron körning, idempotenta återförsök, reservationer, slutdebitering och artefakter.

## Översikt

Den här sidan beskriver offert, reservation, asynkron körning, slutdebitering och artefakter. Följ långa jobb med ID utan att hålla HTTP-anslutningen öppen.

## Förstå körning och debitering

`POST /tools/quote` ger prisversion, minimiavgift och maximal reservation för indata. Offerten är gratis, anropar inga externa tjänster och reserverar inga medel.

Behåll `tool` och `arguments` från offerten och lägg till:

* `priceVersion` — Offertens prisversion
* `maximumChargeMicros` — Offertens maximala reservation

Ändrade priser eller för låg gräns gör att anropet avvisas före start. Hämta och granska en ny offert.

## Reservera och slutdebitera

Vid mottagning reserveras maxbeloppet tillfälligt från förbetalt USD-saldo. Efter avslut debiteras faktisk kostnad och oanvänd reservation återförs.

| Fält | Betydelse |
| - | - |
| `reservedMicros` | Maxbelopp reserverat vid mottagning; behåller ursprungsvärdet efter avslut. |
| `chargedMicros` | Slutlig avgift efter avslut eller fel. `0` under bearbetning betyder att debitering återstår. |
| `currency` | `usd`. 1 USD är 1,000,000 micros. |

Fel och avbrott kan ändå debitera redan uppkomna externa kostnader. Automatisk debitering över maxreservationen sker inte.

## Följ status

Mottagning ger HTTP 202 och ett ID. Följ `Retry-After: 5` och fråga efter samma ID med minst fem sekunders mellanrum.

| Status | Betydelse | Åtgärd |
| - | - | - |
| `queued` | I kö | Vänta minst fem sekunder och fråga igen |
| `running` | Bearbetar | Fråga efter samma ID |
| `waiting` | Väntar på extern bearbetning | Fråga efter samma ID |
| `succeeded` | Lyckad och slutdebiterad | Läs `output` och `chargedMicros` |
| `failed` | Misslyckad; uppkomna kostnader debiterade | Läs `errorCode` och slutavgift |
| `cancelled` | Avbrott slutfört | Kontrollera slutavgift |
| `needs_review` | Resultat eller kostnad behöver granskas | Kör inte igen; kontakta support med ID |

## Förhindra dubbletter med idempotens

En idempotensnyckel hindrar upprepade anrop från att skapa separata körningar. Betalda `POST /tools/{tool}` kräver `Idempotency-Key`.

Nyckeln har 8–128 tecken: bokstäver, siffror, `.`, `_`, `:` eller `-`. Skapa en per logiskt anrop och spara med körnings-ID:t.

* Samma API-nyckel, kropp och idempotensnyckel ger samma körning.
* Ändrad kropp eller API-nyckel med samma idempotensnyckel ger HTTP 409.
* Efter anslutningsfel, skicka igen utan att ändra kropp eller idempotensnyckel.
* Ett nytt anrop för `needs_review` med ny nyckel skapar en till betald körning.

> [!WARNING]
>
> Uteblivet svar bevisar inte att körningen inte accepterades. Skapa ingen ny nyckel när utfallet är okänt.

## Avbryt körning

`POST /tools/executions/{id}/cancel` begär stopp av ännu inte påbörjat arbete. Skaparnyckeln eller projektets `ADMIN` kan begära det.

Redan påbörjad extern bearbetning och dess kostnader kan inte alltid återtas. Kontrollera `cancelRequested`, slutlig `status` och `chargedMicros`.

## Hämta artefakter

Genererade bilder, ljud och video finns i `output.artifacts` med fil-ID, format, storlek, hash och utgångstid. Resultatet innehåller inte filer eller permanenta URL:er.

`GET /tools/executions/{id}/artifacts/{artifactId}/download` ger en URL giltig i upp till fem minuter. Lagrade filer upphör efter 30 dagar.

Även tillfälliga URL:er ger åtkomst till privata data. Logga eller publicera dem inte och lägg inte till Developer Platform-nyckeln.

## Relaterade sidor

Dessa sidor beskriver första körningen och ändpunkter.

* [Kom igång](https://docs.noimosai.com/sv/developers/api/getting-started.md)
* [API-referens](https://docs.noimosai.com/sv/developers/api/reference.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.