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

# निष्पादन और बिलिंग सँभालें

> असिंक्रोनस निष्पादन, सुरक्षित पुनः प्रयास, आरक्षण, अंतिम शुल्क और आर्टिफ़ैक्ट प्राप्ति।

## अवलोकन

यह पेज कोटेशन, रकम आरक्षण, असिंक्रोनस निष्पादन, अंतिम शुल्क और आर्टिफ़ैक्ट बताता है। लंबे काम को ID से ट्रैक करें, HTTP कनेक्शन खुला न रखें।

## निष्पादन और बिलिंग समझें

`POST /tools/quote` इनपुट का मूल्य संस्करण, न्यूनतम शुल्क और अधिकतम आरक्षण देता है। कोटेशन मुफ़्त है: बाहरी सेवा नहीं बुलाता और रकम आरक्षित नहीं करता।

कोटेशन के `tool` और `arguments` रखें और जोड़ें:

* `priceVersion` — कोटेशन का मूल्य संस्करण
* `maximumChargeMicros` — कोटेशन की अधिकतम आरक्षित रकम

कीमत बदलने या सीमा कम होने पर काम शुरू होने से पहले अनुरोध अस्वीकार होता है। नया कोटेशन लेकर जाँचें।

## रकम आरक्षित और शुल्क अंतिम करें

सशुल्क काम स्वीकार होने पर प्रीपेड USD बैलेंस से अधिकतम रकम अस्थायी रूप से रखी जाती है। अंत में वास्तविक शुल्क तय होता है और बची रकम लौटती है।

| फ़ील्ड | अर्थ |
| - | - |
| `reservedMicros` | स्वीकृति पर आरक्षित अधिकतम रकम; अंत में भी शुरुआती मान रहता है। |
| `chargedMicros` | पूर्ण या विफल होने पर अंतिम शुल्क। प्रोसेस के दौरान `0` का अर्थ शुल्क अभी अंतिम नहीं है। |
| `currency` | `usd`। 1 USD बराबर 1,000,000 micros। |

विफलता या रद्द होने पर भी पहले से लगे बाहरी खर्च का शुल्क लग सकता है। अधिकतम आरक्षण से ऊपर अपने आप शुल्क नहीं लगता।

## स्थिति पूछें

स्वीकृति पर HTTP 202 और ID मिलता है। `Retry-After: 5` के अनुसार उसी ID को कम से कम पाँच सेकंड के अंतराल पर पूछें।

| स्थिति | अर्थ | अगला कदम |
| - | - | - |
| `queued` | कतार में | कम से कम पाँच सेकंड बाद पूछें |
| `running` | प्रोसेस जारी | वही ID पूछें |
| `waiting` | बाहरी प्रक्रिया का इंतज़ार | वही ID पूछें |
| `succeeded` | सफल और शुल्क अंतिम | `output` और `chargedMicros` पढ़ें |
| `failed` | विफल; लगे खर्च का शुल्क अंतिम | `errorCode` और अंतिम शुल्क पढ़ें |
| `cancelled` | रद्द करना पूरा | अंतिम शुल्क जाँचें |
| `needs_review` | नतीजे या खर्च की समीक्षा ज़रूरी | दोबारा न चलाएँ; ID के साथ सहायता लें |

## दोहराव रोकने के लिए इडेम्पोटेंसी

इडेम्पोटेंसी कुंजी एक अनुरोध को गलती से कई बार भेजने पर अलग निष्पादन बनने से रोकती है। सशुल्क `POST /tools/{tool}` में `Idempotency-Key` आवश्यक है।

कुंजी में 8–128 अक्षर हों: अंग्रेज़ी अक्षर, अंक, `.`, `_`, `:` या `-`। हर तार्किक अनुरोध की एक कुंजी बनाएँ और ID के साथ रखें।

* वही API कुंजी, बॉडी और इडेम्पोटेंसी कुंजी वही निष्पादन लौटाते हैं।
* उसी इडेम्पोटेंसी कुंजी पर बॉडी या API कुंजी बदलने से HTTP 409 आता है।
* कनेक्शन टूटे तो बॉडी और इडेम्पोटेंसी कुंजी बदले बिना भेजें।
* `needs_review` काम नई कुंजी से भेजना एक और सशुल्क निष्पादन बनाता है।

> [!WARNING]
>
> उत्तर न मिलना अस्वीकृति का प्रमाण नहीं है। नतीजा अज्ञात हो तो नई कुंजी न बनाएँ।

## निष्पादन रद्द करें

`POST /tools/executions/{id}/cancel` अभी शुरू न हुए काम को रोकने का अनुरोध है। निष्पादन बनाने वाली कुंजी या प्रोजेक्ट `ADMIN` यह कर सकता है।

बाहरी प्रक्रिया शुरू हो चुकी हो तो काम और खर्च वापस नहीं हो सकते। `cancelRequested`, अंतिम `status` और `chargedMicros` जाँचें।

## आर्टिफ़ैक्ट लें

बनी तस्वीरें, ऑडियो और वीडियो `output.artifacts` में ID, प्रकार, आकार, हैश और समाप्ति के साथ मिलते हैं। नतीजे में फ़ाइलें या स्थायी URL नहीं होते।

`GET /tools/executions/{id}/artifacts/{artifactId}/download` अधिकतम पाँच मिनट मान्य URL देता है। रखी फ़ाइलें 30 दिन बाद समाप्त होती हैं।

अस्थायी URL भी निजी डेटा तक पहुँच देते हैं। इन्हें लॉग या सार्वजनिक न करें और इनमें Developer Platform कुंजी न जोड़ें।

## संबंधित पेज

पहले निष्पादन और एंडपॉइंट के लिए ये पेज देखें।

* [शुरुआत करें](https://docs.noimosai.com/hi/developers/api/getting-started.md)
* [API संदर्भ](https://docs.noimosai.com/hi/developers/api/reference.md)


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