المطورون · API v1

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

الصور والفيديو والصوت وثلاثي الأبعاد خلف واجهة واحدة، من الرصيد نفسه الذي يستخدمه الاستوديو. أنشئ مفتاحاً من الإعدادات. أداة سطر الأوامر قريباً.

احصل على مفتاح APIالبدء السريع

قريباًأداة سطر الأوامر وحزم SDK قادمة قريباً. واجهة REST أدناه تعمل اليوم.

النماذج
672
نقاط النهاية
9
أدنى شحن
‏3 €
01 · أمثلة

الطلب نفسه، أي مخرجات

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

1# 1. Generate an image2curl -X POST https://femimg.com/api/v1/api/catalog/generations \3  -H "Authorization: Bearer $FEMIMG_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://femimg.com/api/v1/api/catalog/generations/$ID \16  -H "Authorization: Bearer $FEMIMG_API_KEY"17 18# 3. Download the file19curl https://femimg.com/api/v1/api/catalog/generations/$ID/content \20  -H "Authorization: Bearer $FEMIMG_API_KEY" \21  -o result.jpeg
landing.dev.outputTitleluma/uni-v1/text-to-image
02 · البدء السريع

أول عملية في ثلاث خطوات

  1. 01أنشئ مفتاح APIمن الإعدادات > مفاتيح API سمِّ مفتاحاً وانسخه مرة واحدة. اشحن رصيدك ابتداءً من ‏3 € في الفوترة.export FEMIMG_API_KEY="YOUR_API_KEY"
  2. 02ابدأ عمليةأرسل معرّف النموذج ومدخلاته. تحصل فوراً على عملية توليد بحالة queued.POST /api/v1/api/catalog/generations
  3. 03استعلم ثم نزّلاستعلم عن العملية حتى تصبح حالتها succeeded ثم نزّل الملف.GET /api/v1/api/catalog/generations/ID/content
03 · سطر الأوامرقريباً

نفّذ من الطرفية

أداة سطر أوامر للسكربتات وCI ووكلاء البرمجة في الطريق، بالمفاتيح والرصيد نفسيهما. إلى حين صدورها، تعمل كل الطلبات في هذه الصفحة عبر curl.

السكربتات وCIنفّذ من أي صدفة أو مهمة أو cron.
مخرجات JSONمستند JSON واحد لكل تشغيل، جاهز للخطوة التالية.
وكلاء البرمجةيتحقق وكيلك من السعر أولاً ويضع سقفاً لما ينفقه.
04 · أساسيات API

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

المصادقة

رمز Bearer في ترويسة Authorization. أنشئ المفاتيح من الإعدادات.

Authorization: Bearer YOUR_API_KEY

عمليات في الخلفية

بدء العملية يرد فوراً بحالة queued. استعلم حتى تصبح succeeded أو failed أو refunded.

{ "status": "queued" }

السعر أولاً

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

POST /api/v1/api/catalog/quote

إعادة آمنة

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

Idempotency-Key: render-042

الحدود

لكل مفتاح حد للطلبات في الدقيقة. عند تجاوزه تصلك رسالة خطأ 429.

429 Too Many Requests

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

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

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

نقاط النهاية

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

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عرض الأسعار