> ## 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.

# Wykonania i rozliczenia

> Wykonanie asynchroniczne, idempotentne ponawianie, rezerwacje, rozliczenia i artefakty.

## Przegląd

Ta strona opisuje wycenę, rezerwację, wykonanie asynchroniczne, rozliczenie i artefakty. Śledź długie zadania po ID zamiast utrzymywać połączenie HTTP.

## Przebieg wykonania i rozliczeń

`POST /tools/quote` zwraca wersję cen, minimalną opłatę i maksymalną rezerwację dla danych wejściowych. Wycena jest bezpłatna, nie wywołuje usług zewnętrznych ani nie rezerwuje środków.

Zachowaj `tool` i `arguments` z wyceny oraz dodaj:

* `priceVersion` — Wersja cen z wyceny
* `maximumChargeMicros` — Maksymalna rezerwacja z wyceny

Po zmianie cen lub przy zbyt niskim limicie żądanie jest odrzucane przed rozpoczęciem. Pobierz i sprawdź nową wycenę.

## Rezerwowanie i rozliczanie opłat

Przy przyjęciu płatnego zadania maksymalna kwota jest tymczasowo blokowana z salda USD. Po zakończeniu rozliczany jest rzeczywisty koszt, a niewykorzystana część wraca na saldo.

| Pole | Znaczenie |
| - | - |
| `reservedMicros` | Maksimum zarezerwowane przy przyjęciu; zachowuje pierwotną wartość po zakończeniu. |
| `chargedMicros` | Ostateczna opłata po zakończeniu lub błędzie. `0` podczas przetwarzania oznacza brak rozliczenia. |
| `currency` | `usd`. 1 USD to 1,000,000 micros. |

Błędy i anulowanie mogą nadal rozliczyć faktyczne koszty zewnętrzne już poniesione. Opłata nigdy automatycznie nie przekracza maksymalnej rezerwacji.

## Śledzenie stanu

Przyjęcie zwraca HTTP 202 i ID. Stosuj `Retry-After: 5` i odpytuj to samo ID co najmniej co pięć sekund.

| Stan | Znaczenie | Działanie |
| - | - | - |
| `queued` | W kolejce | Odczekaj co najmniej pięć sekund i sprawdź |
| `running` | Przetwarzanie | Odpytuj to samo ID |
| `waiting` | Oczekiwanie na usługę zewnętrzną | Odpytuj to samo ID |
| `succeeded` | Sukces i rozliczenie | Odczytaj `output` i `chargedMicros` |
| `failed` | Błąd; poniesione koszty rozliczone | Odczytaj `errorCode` i końcową opłatę |
| `cancelled` | Anulowanie zakończone | Sprawdź końcową opłatę |
| `needs_review` | Wynik lub koszt wymaga sprawdzenia | Nie uruchamiaj ponownie; przekaż ID pomocy technicznej |

## Zapobieganie duplikatom

Klucz idempotencji zapobiega osobnym wykonaniom po przypadkowym powtórzeniu żądania. Płatne `POST /tools/{tool}` wymaga `Idempotency-Key`.

Klucz ma 8–128 znaków: litery, cyfry, `.`, `_`, `:` lub `-`. Generuj jeden na żądanie logiczne i zapisuj z ID wykonania.

* Ten sam klucz API, korpus i klucz idempotencji zwracają to samo wykonanie.
* Zmiana korpusu lub klucza API przy tym samym kluczu idempotencji daje HTTP 409.
* Po utracie połączenia ponów bez zmiany korpusu i klucza idempotencji.
* Ponowienie `needs_review` z nowym kluczem tworzy kolejne płatne wykonanie.

> [!WARNING]
>
> Brak odpowiedzi nie dowodzi, że wykonanie nie zostało przyjęte. Nie twórz nowego klucza przy nieznanym wyniku.

## Anulowanie wykonania

`POST /tools/executions/{id}/cancel` prosi o zatrzymanie nierozpoczętej pracy. Może tego dokonać klucz tworzący wykonanie lub `ADMIN` projektu.

Rozpoczętego przetwarzania zewnętrznego i jego kosztów nie zawsze da się cofnąć. Sprawdź `cancelRequested`, końcowy `status` i `chargedMicros`.

## Pobieranie artefaktów

Wygenerowane obrazy, dźwięk i wideo występują w `output.artifacts` jako ID, format, rozmiar, hash i termin wygaśnięcia. Wynik nie zawiera plików ani stałych URL.

`GET /tools/executions/{id}/artifacts/{artifactId}/download` zwraca URL ważny do pięciu minut. Pliki są przechowywane przez 30 dni.

Tymczasowe URL też dają dostęp do prywatnych danych. Nie loguj ani nie publikuj ich i nie dodawaj klucza Developer Platform.

## Powiązane strony

Te strony opisują pierwsze wykonanie i endpointy.

* [Pierwsze kroki](https://docs.noimosai.com/pl/developers/api/getting-started.md)
* [Dokumentacja API](https://docs.noimosai.com/pl/developers/api/reference.md)


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