Recraft: Recraft V4.1 Pro Vector
ينشئ Recraft V4.1 Pro Vector أعمال SVG قابلة للتحرير للشعارات والحروف والرسوم التوضيحية المفصّلة. وهو إصدار Pro المتجهي من عائلة V4.1، ويجمع الموجّهات النصية مع مدخلات صورية وأسلوبية اختيارية مع الحفاظ على المخرج المتجهي.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
Recraft V4.1 Pro Vector هو إصدار Pro بصيغة SVG من عائلة توليد الصور V4.1 التابعة لـRecraft. صُمّم للأعمال التي ينبغي أن تبقى نتيجتها رسمًا متجهيًا قابلًا للتحرير: شعارًا أو مفهومًا طباعيًا أو أيقونة أو رسمًا توضيحيًا. يؤكد عرض الشركة المصنّعة لـV4.1 التكوين المقصود والرسم التوضيحي، بينما يعرّف مرجع النموذج الدقيق هذه النسخة منفصلةً عن إصدارات Vector القياسي وPro النقطي وUtility. صورته النهائية SVG وليست تصديرًا نقطيًا عالي الدقة.
رمز النموذج لدى الجهة المنتجة هو recraftv4_1_pro_vector. ليس للمخرجات المتجهية حجم بكسلي ثابت؛ ويقبل مرجع الأحجام أربع عشرة نسبة عرض إلى ارتفاع للنماذج المتجهية، ولا يقبل أبعادًا بكسلية دقيقة. لذلك لا تحدّد إعدادات Pro النقطية بحجم 2K دقة SVG لهذا الإصدار. حدّد النسبة المقصودة وكيف سيُستخدم العمل. بالنسبة إلى الشعار، المخرج المهم هو شكل ظلي واضح ومناطق لونية قابلة للتحرير والتعديل في سير عمل تصميمي.
يدعم النموذج التوليد من نص إلى صورة ومراجع أسلوبية مخصصة اختيارية. الحد الموثّق للموجّه هو 10,000 حرف. يمكن للألوان المفضّلة ولون الخلفية المطلوب والبذرة العشوائية توجيه التوليد، ويتيح سير العمل من مخرج واحد إلى ستة مخرجات. يمكن لأسلوب محفوظ متوافق أو صور مرجعية تثبيت لغة بصرية؛ ويجب أن يتطابق الأسلوب مع النموذج الذي أُنشئ له. لا تتطلب سلسلة V4.1 الرئيسية أسلوبًا مرجعيًا في كل طلب، بخلاف عائلة V4 Styles المخصّصة. للتوليد بأسلوب مرجعي، استخدم من صورة واحدة إلى عشر صور بصيغة PNG أو JPG أو WebP، بإجمالي لا يتجاوز 64 MB وأقل من 20 MB لكل صورة. يجب ألا يقل أقصر ضلع لكل مرجع عن 256 بكسل، وألا يزيد أطول ضلع عن 4,096 بكسل، وألا تتجاوز الدقة 16 ميغابكسل. استخدم إما هذه المراجع أو أسلوبًا محفوظًا متوافقًا، دون الجمع بينهما. في التوليد بأسلوب مرجعي، تتيح المطابقة المرنة تفسيرًا أكثر حرية، بينما تتبع المطابقة الدقيقة المعالجة اللونية والرسم والتكوين والإضاءة بصورة أوثق.
يحدّد وصف المهمة المتجهية المفيد نوع الرسم ومنطق الأشكال ولوحة الألوان ومعالجة الخطوط والترتيب قبل إضافة التفاصيل الزخرفية. لشارة متجر حدائق، اطلب شكلًا ظليًا لبرعم واحد وهندسة مستديرة ولونين مسطّحين وتركيبًا مركزيًا. وللحروف، أدرج الكلمة بالضبط وصِف تسلسلها الهرمي وشكلها، ثم افحص SVG المعاد من حيث وضوح الفراغات الداخلية والتباعد والوضوح بالحجم الصغير. تدعم أمثلة الشركة المصنّعة المتجهية الطباعة التعبيرية والرسم التوضيحي؛ لكنها لا تضمن أن كل حرف أو مسار مولّد هو عمل منجز بالفعل.
توثّق Recraft مسارًا مستقلًا للتحويل من صورة إلى صورة لنماذج V4.1 النقطية والمتجهية. يجمع صورة موجودة وموجّهًا، مع strength من 0 إلى 1 للتحكّم في مدى ابتعاد النتيجة الجديدة عن الأصل. تبقى القوة المنخفضة أقرب، وتسمح القوة الأعلى بتغيير أكبر. لا تقبل هذه العملية إعدادات الأسلوب المخصص لـV4/V4.1؛ لذا ينبغي إعداد تحويل الصورة المصدرية والتوليد بأسلوب مرجعي كمسارين متمايزين. يمكن أن يكون إدخال الصورة PNG أو JPG أو WebP أو SVG ضمن حدود الصور الموثّقة. للتحويل من صورة إلى صورة، قدّم PNG أو JPG أو WebP أو SVG بأقل من 20 MB، ولا تزيد عن 16 ميغابكسل، ويكون كلا ضلعيها بين 256 و4,096 بكسل.
لا يدعم V4.1 أسماء الأساليب المنسّقة ولا إعدادات negative_prompt أو text_layout أو artistic_level أو no_text. حدّد الترتيب والحروف المقصودين في الوصف الإيجابي بدلًا من الاعتماد على آليات V3 الأقدم. لأصل علامة تجارية مفصّل، استخدم SVG كملف عمل، وافحص الهندسة واضبط الألوان أو الأشكال حسب الحاجة قبل وضعه في التخطيط النهائي. يحتفظ إصدار Pro Vector هذا بهويته الخاصة؛ ولا يمكن مبادلته مع النسخ النقطية القياسية أو Utility لمجرد اشتراكها في اسم V4.1.
عبر Ailoot، اختر معرّف هذا النموذج بالضبط في /v1/images/generations وقدّم الموجّه الإبداعي. احتفظ بكل عنصر data معاد، سواء حملت الاستجابة عنوان URL أو محتوى صورة مرمّزًا، واحفظ البايتات الفعلية مع نوع المحتوى المعاد لها. احتفظ ببيانات usage وأي task_id للوسائط مع الأصل، ثم راجع أشكاله وحروفه ومناطقه اللونية ضمن التصميم المقصود.
Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4.1-pro-vector
recraft/recraft-v4.1-pro-vector
recraft/recraft-v4.1-pro-vectorالبداية
ينشئ Recraft V4.1 Pro Vector أعمال SVG قابلة للتحرير للشعارات والحروف والرسوم التوضيحية المفصّلة. وهو إصدار Pro المتجهي من عائلة V4.1، ويجمع الموجّهات النصية مع مدخلات صورية وأسلوبية اختيارية مع الحفاظ على المخرج المتجهي.
- المدخلات المقبولة
- النص · الصور
- النتائج
- الصور
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · Images POST /v1/images/generations
- الإدخال
text,image- الإخراج
image- صيغة الإخراج
- ملف صورة
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود recraft/recraft-v4.1-pro-vector الشروط: استخدم مُحدِّد التوجيه هذا في Ailoot كما هو تمامًا. | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلبمطلوب | القيم والحدود الشروط: | القيمة الافتراضية— |
الحقلn | النوعinteger | المتطلباختياري | القيم والحدود الحد الأدنى: 1 الحد الأقصى: 6 الشروط: | القيمة الافتراضية— |
الحقلaspect_ratio | النوعstring | المتطلباختياري | القيم والحدود 1:1, 4:3, 3:4, 16:9, 9:16, auto الشروط: | القيمة الافتراضية— |
الحقلoutput_format | النوعstring | المتطلباختياري | القيم والحدود svg الشروط: | القيمة الافتراضية— |
الحقلinput_references | النوعarray | المتطلباختياري | القيم والحدود الشروط: | القيمة الافتراضية— |
الحقلquality | النوعstring | المتطلباختياري | القيم والحدود auto, low, medium, high, xhigh, max الشروط: | القيمة الافتراضية— |
تركيبات مواد الإدخال
تحويل النص إلى صورة
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, prompt |
المعلمةoptional | المواصفاتn, aspect_ratio, output_format, input_references, 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.6 لكل صورة مُخرجة |
| الإعداداتتكلفة التوليد التقديرية | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | وحدة الفوترة— | الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.6 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
أمثلة للطلبات
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "recraft/recraft-v4.1-pro-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field."}')
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.1-pro-vector
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · Recraft: Recraft V4.1 Pro Vector
- ما المدخلات والنتائج المتاحة؟
POST /v1/images/generations·recraft/recraft-v4.1-pro-vector:text,image→image- ما الحقول التي يستخدمها الطلب؟
POST /v1/images/generations·recraft/recraft-v4.1-pro-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- ما الحدود المطبقة؟
POST /v1/images/generations·recraft/recraft-v4.1-pro-vector:n.minimum:1;n.maximum:6