تخطي إلى المحتوى
GetAPI
العربية
القائمة

GetAPI.ONE

توليد الصور باستخدام GetAPI.ONE

اختر نموذج صور من الدليل الحالي، وأرسل أصغر طلب معلن لمسار صور ONE، وتحقق من بنية الاستجابة واحفظ الناتج بأمان.

تجهيز طلب مدعوم

  • افتح الدليل الحالي واختر نموذجًا يعلن نقطة توليد الصور.
  • راجع الأسعار الحالية قبل استدعاء مدفوع؛ لا يثبت هذا الدليل سعرًا.
  • ابدأ بمخرج واحد والحقول الموضحة في عقد النموذج فقط.
text
POST https://www.getapi.one/v1/images/generations

إرسال توليد أدنى

  1. اضبط GETAPI_ONE_API_KEY في بيئة عملية موثوقة.
  2. انسخ معرف نموذج الصور الدقيق من الدليل الحالي.
  3. صف العنصر والتكوين والقيود في المطالبة.
  4. اطلب نتيجة واحدة أولًا، ثم وسّع الحقول الاختيارية بعد تأكيد دعم النموذج.
  5. فك مخرج base64 محدود الحجم محليًا. إذا احتوت الاستجابة رابطًا، فسجله لأداة تنزيل معتمدة بقواعد خروج ومضيف صريحة وإعادة تحقق من التحويلات بدل فتحه في عملية API.
shell
curl --fail-with-body https://www.getapi.one/v1/images/generations \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<IMAGE_MODEL_ID_FROM_CURRENT_CATALOG>",
    "prompt": "A clean product diagram of a secure server-side API flow",
    "n": 1
  }' > image-response.json
فحص data[0] وحفظ البايتات المعادة
import base64
import json
from pathlib import Path
from urllib.parse import urlsplit

payload = json.loads(Path("image-response.json").read_text(encoding="utf-8"))
item = payload["data"][0]

if item.get("b64_json"):
    image_bytes = base64.b64decode(item["b64_json"], validate=True)
    if len(image_bytes) > 25 * 1024 * 1024:
        raise ValueError("Image exceeds the local 25 MB safety limit")
    Path("generated-image.bin").write_bytes(image_bytes)
elif item.get("url"):
    url = item["url"]
    parsed = urlsplit(url)
    if parsed.scheme != "https" or not parsed.hostname:
        raise ValueError("Refusing an invalid or non-HTTPS image URL")
    # Do not dereference provider-controlled URLs from a generic server example.
    # Give this record to an approved downloader that enforces your egress and
    # host policy, rejects private/link-local/loopback destinations, revalidates
    # every redirect, sends no ONE credential, and bounds the response bytes.
    Path("generated-image-url.txt").write_text(url, encoding="utf-8")
    print("URL recorded for an egress-controlled downloader")
else:
    raise ValueError("Expected data[0].url or data[0].b64_json")

تقييم النتيجة

فحصشرط النجاح
الالتزام بالمطالبةيوجد العنصر والتكوين المطلوبان.
السلامة والحقوقالناتج مناسب للجمهور المقصود ولديك حقوق استخدام المدخلات المقدمة.
عقد الاستجابةافحص data[0].url أو data[0].b64_json وتحقق منه واحفظ البايتات المعادة.
السجل التشغيلييُسجل معرف النموذج وإصدار المطالبة ومعرف الطلب إن توفر والنتيجة دون المفتاح.

التحقق من النتيجة المتوقعة

  • ينجح طلب HTTP ويتضمن الجسم بنية نتيجة الصور التي يعيدها النموذج المختار.
  • يفتح ملف base64 المفكوك بنوع الصورة المتوقع، أو يُسجل الرابط ثم تُنزله أداة معتمدة ذات ضوابط للخروج فقط.
  • تسجل وحدة ONE الطلب أو الاستخدام المقابل.

إصلاح أخطاء طلبات الصور

العَرَضالإجراء
معامل غير مدعومأزل حقول الحجم والجودة والصيغة والعدد الاختيارية حتى يُؤكد دعمها للنموذج الدقيق.
ناتج فارغ أو غير قابل للاستخدامافحص جسم JSON كاملًا وعالج حقل URL أو البيانات المرمزة الفعلي، ولا تفترض بنية مزود واحدة.
رفض السياسة أو المدخلعدّل المدخل بدل إعادة الطلب نفسه مرارًا.

تخزين المدخلات والمخرجات بأمان

  • احتفظ بالمفاتيح في الخادم، وتحقق من طول المطالبة وعدد المخرجات والحقول الاختيارية قبل التمرير.
  • لا ترسل صورًا سرية أو بيانات شخصية ما لم تسمح إجراءاتك المعتمدة بذلك.
  • عامل الروابط كروابط مؤقتة ما لم ينص عقد المزود صراحة على غير ذلك؛ انسخ النتائج المعتمدة إلى تخزين تتحكم به.
  • لا تمرر ترويسة GetAPI.ONE Authorization إلى رابط صورة معاد مطلقًا.
  • عامل الروابط المعادة كمدخلات غير موثوقة: طبّق سياسة صريحة للخروج والمضيف، واحظر الوجهات الخاصة والمحلية للرابط والاسترجاعية، وأعد التحقق من كل إعادة توجيه في أداة التنزيل المخصصة.

الخطوات التالية