Recraft: Recraft V4 Styles Vector
ينشئ Recraft V4 Styles Vector رسوم SVG قابلة للتحرير من وصف نصي وأسلوب بصري إلزامي. يلائم الأيقونات والشعارات والرسوم التوضيحية المنسّقة التي ينبغي أن تتبع معالجة خطوطها ولوحة ألوانها ورسمها الاتجاه المرجعي نفسه.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
Recraft V4 Styles Vector هو النموذج المنتج لـSVG في سلسلة التوليد المخصّصة للاتساق الأسلوبي من Recraft. يحوّل وصفًا نصيًا إلى عمل متجهي جديد، مع استخدام أسلوب مرجعي مقدّم لتوجيه الرسم والمنطق اللوني والمظهر العام. يفيد في مجموعات الأيقونات المنسّقة ورسوم العلامات التجارية والأنظمة الرسومية التي تتغير موضوعاتها لكن ينبغي أن تظل معالجتها البصرية قابلة للتعرّف. يعيد إصدار Vector رسمًا قابلًا للتحرير بدلًا من صورة فوتوغرافية نقطية.
تعرّف الجهة المنتجة هذا الإصدار باسم recraftv4_styles_vector. مخرجاته SVG دائمًا؛ ولا تحوّلها إعدادات image_format النقطية إلى WebP أو PNG. يقبل كل إصدار متجهي نسب الأبعاد الأربع عشرة الموثّقة بوصفها نسب العرض إلى الارتفاع، بدلًا من أحجام بكسلية دقيقة. ليس لـSVG دقة بكسلية ثابتة، لذا ليست مخرجات النموذج النقطي القياسي بحجم 1K حجمًا بنيويًا لهذا الإصدار. اختر الشكل المطلوب للأصل واستخدام عرضه الصغير أو الكبير عند إعداد وصف المهمة.
يلزم أسلوب لكل عملية توليد. استخدم من صورة واحدة إلى عشر صور مرجعية بصيغة PNG أو JPG أو WebP، أو أسلوبًا محفوظًا متوافقًا بدلًا من مراجع جديدة. ترفض الجهة المنتجة الطلب الذي يجمع معرّف أسلوب محفوظ مع صور مرجعية للأسلوب. الحد الموثّق للمراجع هو 64 MB إجمالًا وأقل من 20 MB لكل ملف. يمكن لأيقونة أو رسم توضيحي واحد واضح تثبيت المعالجة؛ وتفيد عدة مراجع عندما تنتمي سماكة خطوطها وزواياها ومنطق تعبئتها ولوحة ألوانها بالفعل إلى النظام البصري نفسه. يجب ألا يقل أقصر ضلع لكل مرجع عن 256 بكسل، وألا يزيد أطول ضلع عن 4,096 بكسل، وألا تتجاوز دقته الإجمالية 16 ميغابكسل.
المطابقة المرنة هي الافتراضية وتفسّر المرجع بحرية أكبر، بينما تتبع المطابقة الدقيقة رسمه وألوانه وتكوينه وإضاءته عن كثب. في نظام متجهي، استخدم الموجّه لتحديد نوع الرسم والشكل الظلي وعدد العناصر والتخطيط. لمجموعة أيقونات تنقّل، استخدم حدودًا بارزة ومستديرة، وعنصرًا مركزيًا واحدًا لكل صورة، ولوحة من لونين. احتفظ بالأسلوب المرجعي نفسه وغيّر العنصر المسمّى في كل وصف مهمة، بدلًا من خلط مراجع غير مترابطة للحصول على تنوّع.
يسمح مرجع التوليد بموجّهات تصل إلى 10,000 حرف، ومن مخرج واحد إلى ستة مخرجات، وبذرة عشوائية، وألوان مفضّلة، ولون خلفية مطلوب. لا يدعم الموجّهات السلبية ولا أسماء الأساليب المنسّقة ولا إعداد text_layout الأقدم. ولا يوفّر إصدار Styles هذا كذلك التحويل من صورة إلى صورة أو الرسم داخل منطقة: فالمرجع الصوري يوفّر لغة بصرية، لا منطقة للمحو أو رسمًا موجودًا للحفاظ عليه دون تغيير. ينبغي أن تصف التعليمات البنيوية في الوصف الإيجابي الأصل النهائي المقصود.
افحص SVG بالحجم الذي سيُستخدم فيه، خصوصًا عندما يحتوي التصميم على حروف أو فراغات ضيقة أو تفاصيل صغيرة. مطابقة الألوان مع المرجع غير مضمونة، ويمكن أن تتنافس المراجع غير المرتبطة. إذا أصبحت مجموعة الأيقونات متكررة، فغيّر العنصر أو الوضعية أو الترتيب في الموجّه مع الاحتفاظ بالأسلوب المتسق. المخرج المفيد هو أصل متجهي متسق يمكن إعادة تشكيله وتلوينه ضمن سير عمل تصميمي، مع تقييم هندسته ووضوحه وفق وصف المهمة.
عبر Ailoot، اختر معرّف هذا النموذج بالضبط في /v1/images/generations وقدّم الموجّه الإبداعي. احتفظ بكل عنصر data معاد، سواء حملت الاستجابة عنوان URL أو محتوى صورة مرمّزًا، واحفظ البايتات الفعلية مع نوع المحتوى المعاد لها. احتفظ ببيانات usage وأي task_id للوسائط مع الأصل، ثم راجع أشكاله وحروفه ومناطقه اللونية ضمن التصميم المقصود.
Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-styles-vector
recraft/recraft-v4-styles-vector
recraft/recraft-v4-styles-vectorالبداية
ينشئ Recraft V4 Styles Vector رسوم SVG قابلة للتحرير من وصف نصي وأسلوب بصري إلزامي. يلائم الأيقونات والشعارات والرسوم التوضيحية المنسّقة التي ينبغي أن تتبع معالجة خطوطها ولوحة ألوانها ورسمها الاتجاه المرجعي نفسه.
- المدخلات المقبولة
- النص · الصور
- النتائج
- الصور
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · Images POST /v1/images/generations
- الإدخال
text,image- الإخراج
image- صيغة الإخراج
- ملف صورة
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود recraft/recraft-v4-styles-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.1 لكل صورة مُخرجة |
| الإعداداتتكلفة التوليد التقديرية | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | وحدة الفوترة— | شروط الفوترة— | الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.1 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. |
تحجز 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-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-vector
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · Recraft: Recraft V4 Styles Vector
- ما المدخلات والنتائج المتاحة؟
POST /v1/images/generations·recraft/recraft-v4-styles-vector:text,image→image- ما الحقول التي يستخدمها الطلب؟
POST /v1/images/generations·recraft/recraft-v4-styles-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- ما الحدود المطبقة؟
POST /v1/images/generations·recraft/recraft-v4-styles-vector:n.minimum:1;n.maximum:6