GetAPI.ONE
توليد الصور باستخدام GetAPI.ONE
اختر نموذج صور من الدليل الحالي، وأرسل أصغر طلب معلن لمسار صور ONE، وتحقق من بنية الاستجابة واحفظ الناتج بأمان.
تجهيز طلب مدعوم
- افتح الدليل الحالي واختر نموذجًا يعلن نقطة توليد الصور.
- راجع الأسعار الحالية قبل استدعاء مدفوع؛ لا يثبت هذا الدليل سعرًا.
- ابدأ بمخرج واحد والحقول الموضحة في عقد النموذج فقط.
POST https://www.getapi.one/v1/images/generationsإرسال توليد أدنى
- اضبط GETAPI_ONE_API_KEY في بيئة عملية موثوقة.
- انسخ معرف نموذج الصور الدقيق من الدليل الحالي.
- صف العنصر والتكوين والقيود في المطالبة.
- اطلب نتيجة واحدة أولًا، ثم وسّع الحقول الاختيارية بعد تأكيد دعم النموذج.
- فك مخرج base64 محدود الحجم محليًا. إذا احتوت الاستجابة رابطًا، فسجله لأداة تنزيل معتمدة بقواعد خروج ومضيف صريحة وإعادة تحقق من التحويلات بدل فتحه في عملية API.
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.jsonimport 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 إلى رابط صورة معاد مطلقًا.
- عامل الروابط المعادة كمدخلات غير موثوقة: طبّق سياسة صريحة للخروج والمضيف، واحظر الوجهات الخاصة والمحلية للرابط والاسترجاعية، وأعد التحقق من كل إعادة توجيه في أداة التنزيل المخصصة.