डेवलपर · API v1

एक API.
हर मॉडल.

इमेज, वीडियो, ऑडियो और 3D एक API के पीछे, स्टूडियो वाले ही बैलेंस से। कुंजी सेटिंग्स में बनाएं और npm से CLI इंस्टॉल करें।

CLI इंस्टॉल करें
npm i -g ineveo
मॉडल
699
एंडपॉइंट
9
न्यूनतम टॉप-अप
€3
01 · उदाहरण

एक ही कॉल, कोई भी आउटपुट

इमेज, वीडियो और स्पीच के बीच बदलने के लिए बस मॉडल ID बदलें। फ़ील्ड मॉडल के अनुसार होते हैं।

1# 1. Generate an image2curl -X POST https://ineveo.com/api/v1/api/catalog/generations \3  -H "Authorization: Bearer $INEVEO_API_KEY" \4  -H 'Content-Type: application/json' \5  -H "Idempotency-Key: $(uuidgen)" \6  -d '{7  "modelId": "luma/uni-v1/text-to-image",8  "inputs": {9    "prompt": "Neon city street after rain, cinematic night",10    "size": "16:9"11  }12}'13 14# 2. Poll with the generation id from step 1 until its status is succeeded15curl https://ineveo.com/api/v1/api/catalog/generations/$ID \16  -H "Authorization: Bearer $INEVEO_API_KEY"17 18# 3. Download the file19curl https://ineveo.com/api/v1/api/catalog/generations/$ID/content \20  -H "Authorization: Bearer $INEVEO_API_KEY" \21  -o result.jpeg
सैंपल रेंडरluma/uni-v1/text-to-image
[02] क्विकस्टार्ट

तीन चरणों में पहला रेंडर

  1. 01API key बनाएँअपने ईमेल से साइन इन करें, Settings में API keys खोलें और एक key बनाएँ। Billing में €3 से टॉप-अप करें।export INEVEO_API_KEY="YOUR_API_KEY"
  2. 02CLI इंस्टॉल करेंएक ही कमांड: npm i -g ineveo। यह आपकी key INEVEO_API_KEY से पढ़ता है।npm i -g ineveo
  3. 03पहला रेंडर करेंकैटलॉग से मॉडल ID चुनें और प्रॉम्प्ट भेजें। बिना कुछ खर्च किए कीमत देखने के लिए --dry-run जोड़ें।ineveo run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
[03] CLI

टर्मिनल से रेंडर करें

किसी भी मॉडल को shell, CI जॉब या कोडिंग एजेंट से चलाएँ। हर रेंडर की कीमत शुरू होने से पहले तय होती है और उसी बैलेंस से कटती है।

स्क्रिप्ट और CIमॉडल का हर फ़ील्ड एक फ़्लैग है; लोकल फ़ाइल आपके लिए अपलोड हो जाती है।
stdout पर JSONहर रन पर एक JSON डॉक्यूमेंट, प्रोग्रेस और एरर stderr पर, विफल होने पर नॉन-ज़ीरो एग्ज़िट कोड।
कोडिंग एजेंटएक skill फ़ाइल आपके एजेंट को पहले कीमत जाँचना और उसकी सीमा तय करना सिखाती है।
पूरी CLI गाइड →
कमांडयह क्या करता है
ineveo models --type videoहर वीडियो मॉडल उसकी शुरुआती कीमत के साथ
ineveo run <model> -hमॉडल के फ़ील्ड, लाइव: टाइप, डिफ़ॉल्ट, अनुमत मान
ineveo run <model> -p "<prompt>" -o ./out/रेंडर करें और नतीजा एक फ़ोल्डर में सेव करें
ineveo run <model> -p "..." --dry-runसटीक कीमत, बिना कुछ खर्च किए
ineveo run <model> -p "..." --max-price 0.50कीमत ज़्यादा हो तो चलाने से मना करें
ineveo run <model> -p "..." --json -o ./out/एक JSON नतीजा, अगले चरण के लिए तैयार
ineveo skill installअपने कोडिंग एजेंट को CLI इस्तेमाल करना सिखाएँ
[04] API की ज़रूरी बातें

प्रोडक्शन के लिए बना

ऑथेंटिकेशन

Authorization हेडर में एक Bearer टोकन। Settings में keys बनाएँ और किसी को भी कभी भी रद्द करें।

Authorization: Bearer YOUR_API_KEY

बैकग्राउंड रेंडर

रेंडर शुरू करने पर तुरंत queued स्टेटस मिलता है। रेंडर को तब तक पोल करें जब तक वह सफल, विफल या रिफ़ंड न हो जाए।

{ "status": "queued" }

पहले कीमत

कुछ भी शुरू किए बिना अपने इनपुट की सटीक कीमत पूछें। हर राशि यूरो सेंट में है।

POST /api/v1/api/catalog/quote

सुरक्षित रीट्राई

Idempotency-Key हेडर भेजें, तो दोबारा भेजा गया अनुरोध कभी दो बार चार्ज नहीं होगा।

Idempotency-Key: render-042

सीमाएँ

हर key की प्रति मिनट सीमा और एक वैकल्पिक दैनिक सीमा होती है। सीमा पार होने पर API 429 लौटाता है।

429 Too Many Requests

एरर और रिफ़ंड

कोड और मैसेज के साथ JSON एरर। विफल रेंडर अपने आप आपके बैलेंस में रिफ़ंड हो जाता है।

{ "status": "refunded" }
[05] रेफ़रेंस

एंडपॉइंट

बेस URL https://ineveo.com/api/v1

पूरा API रेफ़रेंस →
GET/api/catalog/meआपकी key और बैलेंस
GET/api/catalog/modelsसभी मॉडल
GET/api/catalog/models/detail?id=MODEL_IDएक मॉडल और उसके फ़ील्ड
POST/api/catalog/quoteसटीक इनपुट की कीमत
POST/api/catalog/generationsरेंडर शुरू करें
GET/api/catalog/generationsआपके हाल के रेंडर
GET/api/catalog/generations/IDएक रेंडर का स्टेटस
GET/api/catalog/generations/ID/contentनतीजे की फ़ाइल
DELETE/api/catalog/generations/IDरेंडर हटाएँ

€3 टॉप-अप करें और आज ही शिप करें

सेटिंग्स में API कुंजी बनाएं और कोई भी मॉडल चलाएं। CLI npm पर उपलब्ध है। विफल रेंडर लौटा दिए जाते हैं।