Hoppa till huvudinnehåll

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

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