Przejdź do głównej treści

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

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