Recraft: Recraft V4 Styles Pro Vector
Recraft V4 Styles Pro Vector هو إصدار Pro بصيغة SVG من عائلة Recraft للصور المتسقة أسلوبيًا. ينشئ رسومًا متجهية قابلة للتحرير من وصف نصي وأسلوب مرجعي إلزامي، لرسوم العلامات التجارية المفصّلة والمفاهيم الحروفية والأصول الرسومية المنسّقة.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
Recraft V4 Styles Pro Vector هو نموذج Pro المتجهي في عائلة V4 Styles المخصّصة. غايته إنشاء أعمال SVG جديدة تتبع معالجتها البصرية أسلوبًا مرجعيًا مقدّمًا. يجمع النموذج وصفًا نصيًا لما يجب رسمه مع مراجع تثبت كيفية ظهوره. تشمل الأعمال العملية رسوم العلامات التجارية والمفاهيم الحروفية والأصول الرسومية المنسّقة التي تحتاج فيها الملامس والرسم والمنطق اللوني والتكوين إلى اتجاه مشترك.
رمز النموذج الدقيق لدى الجهة المنتجة هو recraftv4_styles_pro_vector، وهو منفصل عن نموذج Styles Vector القياسي ونموذج Styles Pro النقطي. يعيد SVG قابلًا للتحرير. ينص مرجع الأحجام لدى الجهة المنتجة صراحةً على أن المخرجات المتجهية ليس لها حجم بكسلي ثابت وتقبل نسب الأبعاد فقط؛ لذا لا تمثل الأبعاد النقطية 2K الخاصة بـStyles Pro وعدًا بدقة بكسلية لإصدار Pro Vector هذا. تنتمي تسمية Pro إلى النسخة المتجهية المسماة؛ فجهّز العمل وفق هندسته واستخدامه المقصودين بدلًا من معاملته كصورة نقطية مكبّرة.
تحتاج كل عملية توليد Styles إلى أسلوب. يمكن أن يوفّره أسلوب محفوظ متوافق أو من صورة واحدة إلى عشر صور مرجعية بصيغة PNG أو JPG أو WebP؛ والمدخلان بديلان. يجب أن يكون كل مرجع أقل من 20 MB، وألا يزيد مجموع المراجع على 64 MB في سير العمل الموثّق. فضّل رسمًا توضيحيًا واحدًا نظيفًا عندما يكون اتجاهه واضحًا بالفعل. وإذا لزمت عدة مراجع، فاختر أصولًا ذات شكل ولوحة ألوان ومعالجة متسقة، حتى يعمّم النموذج تلك اللغة البصرية بدلًا من تجميع زخارف متنافسة. يجب ألا يقل أقصر ضلع لكل مرجع عن 256 بكسل، وألا يزيد أطول ضلع عن 4,096 بكسل، وألا تتجاوز دقته الإجمالية 16 ميغابكسل.
اختر المطابقة الدقيقة عندما ينبغي أن توجّه معالجة المرجع المخرجات عن كثب، أو المطابقة المرنة الافتراضية عندما يفيد تفسير أكثر حرية. يظل الموجّه متحكمًا في الموضوع الجديد والترتيب والوضعية والمشهد. لعمل متجهي تحريري مفصّل، اطلب شارة نباتية مركزية بثلاث أوراق كبيرة وشكل ظلي مدمج ونظام من لونين مقتصدين. حدّد التسلسل الهرمي والعلاقات بين الأشكال صراحةً؛ فالمرجع الأسلوبي وحده لا يصف قرارات المحتوى الجديد هذه.
تدعم الجهة المنتجة إعدادات الألوان المفضّلة ولون الخلفية وبذرة عشوائية وموجّهات تصل إلى 10,000 حرف ومن مخرج واحد إلى ستة مخرجات في العملية. تبقى النتيجة المتجهية SVG بغض النظر عن إعداد image_format النقطي. لا تدعم سلسلة Styles المخصّصة التحويل من صورة إلى صورة أو الرسم داخل منطقة، ولا تقبل آليات الأسلوب المنسّق أو negative_prompt أو text_layout القديمة. لذلك تعد مطابقة المراجع وتحرير رسم موجود عمليتين مختلفتين، وليستا معنيين قابلين للتبادل لإدخال الصور.
استخدم مراجع واضحة وعالية الدقة؛ فإعادة إنتاج الألوان بدقة غير مضمونة. أبقِ الاستخدام المقصود ظاهرًا في وصف المهمة: يحتاج الشعار إلى أشكال مقروءة بالحجم الصغير، بينما قد يسمح الرسم التحريري بمزيد من التفاصيل. راجع حروف SVG وتباعده وأشكاله الظلية ومناطقه اللونية في التكوين المستهدف، ثم حسّن الوصف النصي عندما يحتاج الموضوع أو التخطيط إلى تغيير. أعد استخدام الأسلوب المتوافق نفسه للأصول اللاحقة بدلًا من إضافة صور مرجعية غير مرتبطة لفرض التنويع.
عبر Ailoot، اختر معرّف هذا النموذج بالضبط في /v1/images/generations وقدّم الموجّه الإبداعي. احتفظ بكل عنصر data معاد، سواء حملت الاستجابة عنوان URL أو محتوى صورة مرمّزًا، واحفظ البايتات الفعلية مع نوع المحتوى المعاد لها. احتفظ ببيانات usage وأي task_id للوسائط مع الأصل، ثم راجع أشكاله وحروفه ومناطقه اللونية ضمن التصميم المقصود.
Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-styles-pro-vector
recraft/recraft-v4-styles-pro-vector
recraft/recraft-v4-styles-pro-vectorالبداية
Recraft V4 Styles Pro Vector هو إصدار Pro بصيغة SVG من عائلة Recraft للصور المتسقة أسلوبيًا. ينشئ رسومًا متجهية قابلة للتحرير من وصف نصي وأسلوب مرجعي إلزامي، لرسوم العلامات التجارية المفصّلة والمفاهيم الحروفية والأصول الرسومية المنسّقة.
- المدخلات المقبولة
- النص · الصور
- النتائج
- الصور
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · Images POST /v1/images/generations
- الإدخال
text,image- الإخراج
image- صيغة الإخراج
- ملف صورة
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود recraft/recraft-v4-styles-pro-vector الشروط: استخدم مُحدِّد التوجيه هذا في Ailoot كما هو تمامًا. | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلبمطلوب | القيم والحدود الشروط: | القيمة الافتراضية— |
الحقلn | النوعinteger | المتطلباختياري | القيم والحدود الحد الأدنى: 1 الحد الأقصى: 6 الشروط: | القيمة الافتراضية— |
الحقلaspect_ratio | النوعstring | المتطلباختياري | القيم والحدود 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto الشروط: | القيمة الافتراضية— |
الحقلoutput_format | النوعstring | المتطلباختياري | القيم والحدود svg الشروط: | القيمة الافتراضية— |
الحقلinput_references | النوعarray | المتطلبمطلوب | القيم والحدود الشروط: | القيمة الافتراضية— |
الحقلquality | النوعstring | المتطلباختياري | القيم والحدود auto, low, medium, high, xhigh, max الشروط: | القيمة الافتراضية— |
تركيبات مواد الإدخال
reference_guided_image
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, prompt, input_references |
المعلمةoptional | المواصفاتn, aspect_ratio, output_format, quality |
المعلمةmaterial_types | المواصفاتtext, image |
المعلمةconditions | المواصفاتاستخدم مُحدِّد التوجيه هذا في Ailoot كما هو تمامًا., الجودة عنصر تحكم مشترك موثق؛ ويتجاهله المزوّدون الذين لا يتيحون ضبط الجودة. لا يُوعَد بتحسين الجودة لكل نموذج على حدة. |
دورة الحياة: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · القيمة الفعلية المُعادة لـ task_id أو سجل المكتبة المحدد؛ أما operation_id فهو معرّف مستقل
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
الباقات
كيفية احتساب الرسوم النهائية
تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
- الوضع السريع
- غير محدد عند اختيار الوضع السريع
- الوضع المرن
- غير محدد عند اختيار وضع flex
- أقصى جهد للاستدلال
- غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال
تعرفات تقديرية للمقارنة
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | جدول التعرفة | الكمية المتوقعة | وحدة الفوترة | شروط الفوترة | الرسوم |
|---|---|---|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | الكمية المتوقعة— | وحدة الفوترة— | شروط الفوترة— | الرسوم الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز |
| الإعداداتمرجع إدخال | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل طلب | شروط الفوترةإنشاء النمط عند التوليد باستخدام مراجع نمطية؛ يُحتسب مرة واحدة لكل طلب، بالإضافة إلى سعر صورة المخرجات. | الرسوم الإدخال · مرجع إدخال · تقدير للمقارنة فقط $0.01 لكل طلب تقدير استرشادي فقط؛ تُحدَّد الرسوم النهائية وفق الفاتورة الأصلية المسجلة. |
| الإعداداتصورة ناتجة | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل صورة مُخرجة | شروط الفوترة— | الرسوم الإخراج · صورة ناتجة · تقدير للمقارنة فقط $0.24 لكل صورة مُخرجة |
| الإعداداتتكلفة التوليد التقديرية | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | وحدة الفوترة— | شروط الفوترة— | الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.24 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
أمثلة للطلبات
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
: "${AILOOT_IMAGE_URL:?Set an actual customer material or documented value}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "recraft/recraft-v4-styles-pro-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field.", "input_references": [{"type": "image_url", "image_url": {"url": "YOUR_ACCESSIBLE_IMAGE_URL"}}]}')
p['input_references'][0]['image_url']['url']=os.environ['AILOOT_IMAGE_URL']
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
استلام النتائج وحفظها
Ailoot Ultra · Images
نزّل كل صورة مُرجعة أو احفظ محتواها بصيغة Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}
الاحتفاظ بكل النتائج المكتملة
احفظ كل صورة مكتملة؛ نزّلها من كل URL مُرجع، أو فك ترميز محتواها بصيغة Base64.
احتفظ بالاستجابة والترويسات كاملة، والمعرّفات الأصلية، وكل مخرج فعلي، وجميع حقول الاستخدام والمحاسبة. احفظ كل أصل فريد مملوك لك، واحتفظ بكل دور يشير إليه.
عند الحاجة إلى التحقق من الاستجابة الأصلية
احتفظ بقيمة X-Client-Request-ID الأصلية، والاستجابة والترويسات. النتيجة المجهولة أو result_pending_check لا تجيز إنشاءً ثانيًا.
حقول الاستجابة
| الحقل | النوع |
|---|---|
الحقلdata[].url | النوعstring |
الحقلdata[].b64_json | النوعstring |
الحقلusage | النوعobject |
الأخطاء والخطوات التالية
| الاستجابة | الشرط | الخطوة التالية |
|---|---|---|
الاستجابة400 · invalid_request_error | الشرطأحد الحقول المطلوبة أو مُحدِّد النموذج أو النوع أو تمثيل الإدخال غير صالح. | الخطوة التاليةافحص تفاصيل التحقق المُعادة قبل إعداد طلب مستقل. |
الاستجابة | الشرطالطلب الأصلي أو نتيجته مجهولان أو يحتاجان إلى تحقق. | الخطوة التاليةاحتفظ بالمعرّفات والترويسات الأصلية؛ واقرأ فقط سجلات الحالة أو المكتبة المدعومة. لا ترسل طلب الإنشاء مجددًا. |
الأسماء البديلة
الأسماء البديلة للنموذج
Ailoot Ultra recraft/recraft-v4-styles-pro-vector
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · Recraft: Recraft V4 Styles Pro Vector
- ما المدخلات والنتائج المتاحة؟
POST /v1/images/generations·recraft/recraft-v4-styles-pro-vector:text,image→image- ما الحقول التي يستخدمها الطلب؟
POST /v1/images/generations·recraft/recraft-v4-styles-pro-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- ما الحدود المطبقة؟
POST /v1/images/generations·recraft/recraft-v4-styles-pro-vector:n.minimum:1;n.maximum:6