للمطورين · API v1

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

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

احصل على مفتاح APIبدء سريع
تثبيت CLI
$ npm i -g pufy-io
النماذج
721
نقاط النهاية
9
الحد الأدنى للشحن
‏3 €
أمثلة

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

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

1# 1. Generate an image2curl -X POST https://pufy.io/api/v1/api/catalog/generations \3  -H "Authorization: Bearer $PUFY_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://pufy.io/api/v1/api/catalog/generations/$ID \16  -H "Authorization: Bearer $PUFY_API_KEY"17 18# 3. Download the file19curl https://pufy.io/api/v1/api/catalog/generations/$ID/content \20  -H "Authorization: Bearer $PUFY_API_KEY" \21  -o result.jpeg
مثال على التوليدluma/uni-v1/text-to-image
بدء سريع

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

  1. 1أنشئ مفتاح APIمن الإعدادات > مفاتيح API سمِّ مفتاحًا وانسخه مرة واحدة. اشحن من ‏3 € في الفوترة.export PUFY_API_KEY="YOUR_API_KEY"
  2. 2ثبّت أداة CLIتُثبَّت أداة سطر الأوامر pufy عبر npm أو pnpm أو bun.npm i -g pufy-io
  3. 3نفّذ أول عملية توليداختر معرّف نموذج من الكتالوج وأرسل وصفًا. أضف --dry-run لمعرفة السعر دون إنفاق أي شيء.pufy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
CLI

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

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

السكربتات وCIكل حقل في النموذج خيار سطر أوامر، ويُرفع الملف المحلي نيابةً عنك.
JSON على stdoutمستند JSON واحد لكل تشغيل، والتقدم والأخطاء على stderr، ورمز خروج غير صفري عند الفشل.
وكلاء البرمجةملف مهارة يعلّم وكيلك أن يتحقق من السعر أولًا وأن يضع له حدًا.
دليل CLI الكامل →
الأمرما يفعله
pufy loginالصق مفتاح API مرة واحدة، فيُتحقق منه ويُحفظ
pufy whoamiاسم المفتاح ورصيدك
pufy models --type videoكل نماذج الفيديو مع سعرها الابتدائي
pufy run <model> -hحقول النموذج مباشرة: النوع والقيمة الافتراضية والقيم المسموح بها
pufy run <model> -p "<prompt>" -o ./out/التوليد وحفظ النتيجة في مجلد
pufy run <model> -p "..." --dry-runالسعر الدقيق دون إنفاق أي شيء
pufy run <model> -p "..." --max-price 0.50رفض التشغيل إذا كان السعر أعلى
pufy run <model> -p "..." --json -o ./out/نتيجة JSON واحدة جاهزة للخطوة التالية
pufy skill installعلّم وكيل البرمجة استخدام CLI
أساسيات 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" }
المرجع

نقاط النهاية

عنوان URL الأساسي https://pufy.io/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عرض الأسعار