للمطورين · API v1

API واحدة.
كل النماذج.

صور وفيديو وصوت وثلاثي الأبعاد خلف واجهة API واحدة، بنفس رصيد الاستوديو. أنشئ مفتاحًا من الإعدادات وثبّت أداة CLI عبر npm.

احصل على مفتاح APIبدء سريع
ثبّت أداة CLI
npm i -g ineveo
النماذج
699
نقاط النهاية
9
الحد الأدنى للشحن
‏3 €
01 · أمثلة

الاستدعاء نفسه، أي مخرجات

غيّر معرّف النموذج للتبديل بين الصورة والفيديو والكلام. الحقول تتبع النموذج.

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. 01أنشئ مفتاح APIسجّل الدخول ببريدك الإلكتروني، وافتح الإعدادات ثم مفاتيح API وأنشئ مفتاحًا. اشحن رصيدك بدءًا من ‏3 € في صفحة الفواتير.export INEVEO_API_KEY="YOUR_API_KEY"
  2. 02ثبّت أداة CLIأمر واحد: npm i -g ineveo. تقرأ الأداة مفتاحك من INEVEO_API_KEY.npm i -g ineveo
  3. 03نفّذ أول عملية توليداختر معرّف نموذج من الكتالوج وأرسل وصفًا. أضف --dry-run لمعرفة السعر دون إنفاق أي شيء.ineveo run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
[03] CLI

التوليد من الطرفية

شغّل أي نموذج من shell أو مهمة CI أو وكيل برمجة. يُحدَّد سعر كل عملية توليد قبل بدئها ويُخصم من الرصيد نفسه.

السكربتات وCIكل حقل في النموذج خيار سطر أوامر، ويُرفع الملف المحلي نيابةً عنك.
JSON على stdoutمستند JSON واحد لكل تشغيل، والتقدم والأخطاء على stderr، ورمز خروج غير صفري عند الفشل.
وكلاء البرمجةملف مهارة يعلّم وكيلك أن يتحقق من السعر أولًا وأن يضع له حدًا.
دليل 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

مصممة للإنتاج

المصادقة

رمز Bearer في ترويسة Authorization. أنشئ المفاتيح من الإعدادات وألغِ أيًّا منها في أي وقت.

Authorization: Bearer YOUR_API_KEY

التوليد في الخلفية

بدء عملية توليد يرد فورًا بالحالة queued. استعلم عنها حتى تنجح أو تفشل أو يُسترد مبلغها.

{ "status": "queued" }

السعر أولًا

اطلب السعر الدقيق لمدخلاتك دون بدء أي شيء. كل المبالغ بسنتات اليورو.

POST /api/v1/api/catalog/quote

إعادة محاولة آمنة

أرسل ترويسة Idempotency-Key ولن يُحتسب الطلب المعاد مرتين أبدًا.

Idempotency-Key: render-042

الحدود

لكل مفتاح حد في الدقيقة وسقف يومي اختياري. بعد تجاوز الحد ترد API بالرمز 429.

429 Too Many Requests

الأخطاء والاسترداد

أخطاء JSON برمز ورسالة. عملية التوليد التي تفشل يُرد مبلغها إلى رصيدك تلقائيًا.

{ "status": "refunded" }
[05] المرجع

نقاط النهاية

عنوان URL الأساسي https://ineveo.com/api/v1

مرجع API الكامل →
GET/api/catalog/meمفتاحك ورصيدك
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. تُسترد العمليات الفاشلة.

احصل على مفتاح APIعرض الأسعار