واجهة Ineveo البرمجية
كل نماذج الكتالوج من شيفرتك. رصيد واحد وبنفس أسعار الاستوديو.
1 · المصادقة
أنشئ مفتاحًا من الإعدادات > مفاتيح API. أرسله مع كل طلب كرمز Bearer واحتفظ به على خادمك، لا في متصفح أو تطبيق.
curl https://ineveo.com/api/v1/api/catalog/me \
-H 'Authorization: Bearer YOUR_API_KEY'2 · اختر نموذجًا
اختر نموذجًا لترى طلبًا جاهزًا مبنيًا من حقوله الخاصة. الحقول المطلوبة معبأة، وكل إعداد اختياري يستخدم القيمة الافتراضية للنموذج.
ineveo/fast-image/text-to-image| الاسم | النوع | مطلوب | الافتراضي |
|---|---|---|---|
| prompt | text | نعم | - |
| aspect_ratio | 1:1 | 2:1 | 1:2 | 3:1 | 1:3 | 21:9 | ... | لا | 1:1 |
3 · ابدأ التوليد
استدعاء واحد يحسب سعر مدخلاتك بالضبط ويخصمه من رصيدك. تعود الاستجابة فورًا بالحالة queued، ويعمل التوليد في الخلفية. أرسل ترويسة Idempotency-Key حتى لا يُخصم المبلغ مرتين عند إعادة إرسال الطلب.
curl -X POST https://ineveo.com/api/v1/api/catalog/generations \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"modelId": "ineveo/fast-image/text-to-image",
"inputs": {
"prompt": "a lighthouse on a cliff at dusk, soft light"
}
}'تحقق من السعر أولًا (اختياري)
المدخلات نفسها، مسعّرة دون بدء أي شيء. الإجابة بالسنت.
curl -X POST https://ineveo.com/api/v1/api/catalog/quote \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"modelId":"ineveo/fast-image/text-to-image","inputs":{"prompt":"a lighthouse on a cliff at dusk, soft light"}}'4 · استعلم ونزّل
اطلب حالة التوليد كل بضع ثوانٍ حتى تصبح succeeded أو failed أو refunded. عند النجاح، نزّل الملف من contentUrl بالمفتاح نفسه. أما النموذج النصي فيعيد إجابته في textOutput بدلًا من ذلك.
curl https://ineveo.com/api/v1/api/catalog/generations/GENERATION_ID \
-H 'Authorization: Bearer YOUR_API_KEY'curl https://ineveo.com/api/v1/api/catalog/generations/GENERATION_ID/content \
-H 'Authorization: Bearer YOUR_API_KEY' \
-o result.pngنقاط النهاية
عنوان URL الأساسي: https://ineveo.com/api/v1/api/catalog
| GET | /me | مفتاحك ورصيدك |
| GET | /models | كل النماذج |
| GET | /models/detail?id=MODEL_ID | نموذج واحد وحقوله |
| POST | /quote | السعر لمدخلات محددة |
| POST | /generations | بدء التوليد |
| GET | /generations | عمليات التوليد الأخيرة |
| GET | /generations/ID | حالة عملية توليد واحدة |
| GET | /generations/ID/content | ملف النتيجة |
| DELETE | /generations/ID | حذف عملية توليد |
الأسعار والرصيد
تستخدم عمليات التوليد عبر API الرصيد نفسه المستخدم في الاستوديو وبالتكلفة نفسها. كل المبالغ في API بسنتات اليورو: costCents هو ما خُصم مقابل التوليد، وbalanceCents هو المتبقي.
الأخطاء والحدود
تعود الأخطاء بصيغة JSON مع رمز ورسالة. 401: المفتاح مفقود أو خاطئ أو ملغى. 400: أحد الحقول غير صالح (تذكره التفاصيل). 402: الرصيد غير كافٍ. 429: طلبات كثيرة جدًا، خفف السرعة. تُسترد قيمة التوليد الفاشل تلقائيًا. ستُنشر الحدود الدقيقة عند إطلاق المفاتيح. 403 مع صفحة HTML: أُوقف الطلب قبل وصوله إلى API، غالبًا بسبب User-Agent. القيمة الافتراضية في Python-urllib محظورة، أرسل قيمتك الخاصة، مثل User-Agent: my-app/1.0.