# واجهة API لـ Z Image مرجع API كامل لتوليد text-to-image عبر Z Image. ## متغيرات النموذج تدعم واجهة API هذه متغيرا واحدا للنموذج: | النموذج | ID | الوصف | |-------|-----|-------------| | **Z Image** | `z-image` | توليد text-to-image سريع | ## مقارنة سريعة | الميزة | Z Image | |---------|---------| | الإدخال | موجه نصي | | الإخراج | صورة مولدة واحدة | | نسب العرض إلى الارتفاع | عدة نسب مدعومة | | الدقة | مشتقة من قيم نسبة width/height | | `seed` | اختياري | ### نسب العرض إلى الارتفاع المدعومة يجب أن يكون زوج `width:height` واحدا من: `1:1`, `3:2`, `2:3`, `3:4`, `4:3`, `9:16`, `16:9`, `9:21` ## Z Image (Text-to-Image) ### نقطة النهاية ``` POST /api/v1/image/task ``` ### معلمات الطلب #### مطلوبة | المعلمة | النوع | الوصف | |-----------|------|-------------| | `model_name` | string | يجب أن تكون `"z-image"` | | `prompt` | string | موجه توليد الصورة | | `width` | number | قيمة نسبة العرض (مثلا `16` لـ `16:9`) | | `height` | number | قيمة نسبة الارتفاع (مثلا `9` لـ `16:9`) | #### اختيارية | المعلمة | النوع | الوصف | |-----------|------|-------------| | `seed` | number | بذرة عشوائية ضمن النطاق `[0, 2147483647]`. استخدم `null` أو `0` للتوليد العشوائي. | ### مثال طلب ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'z-image', prompt: 'A cinematic portrait of a traveler standing on a cliff at golden hour', width: 16, height: 9, seed: 0 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## تنسيق الاستجابة استجابة الإرسال: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/image/{task_id}", "task_status": "submitted" } } ``` استعلم باستخدام `GET /api/v1/image/{task_id}`. حالات المهمة: `submitted`, `processing`, `succeed`, `failed`. تعرض استجابات الاستعلام الناجحة روابط الصور المولدة ضمن `data.task_result.images[].url`. ## أفضل الممارسات - استخدم قيم النسبة، لا أبعاد البكسل، لـ `width` و`height`. - اجعل الموجهات وصفية لكنها مركزة على الموضوع والإضاءة والتكوين. - استخدم `seed` ثابتا عندما تريد توليدات قابلة للتكرار أثناء الاختبار.