Recraft: Recraft V4 Pro Vector

ينتج Recraft V4 Pro Vector أعمالًا بصيغة SVG قابلة للتحرير للتكوينات المفصّلة والشعارات والرسوم التوضيحية. وهو إصدار Pro المتجهي من V4، ويدعم أوصاف التوليد من نص إلى صورة ومسارات مستقلة من صورة إلى صورة، دون إسناد أحجام بكسلية نقطية إلى SVG.

Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-pro-vector

عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.

Recraft V4 Pro Vector هو نموذج Pro بصيغة SVG في جيل V4 من Recraft. تركّز العائلة على الحكم البصري والعلاقات اللونية المتسقة والتكوين والتفسير التفصيلي لوصف المهمة الإبداعية. يستهدف فرع Pro التفاصيل الأدق والتكوينات الأكثر تطلبًا، بينما يوفّر إصدار Vector هذا أعمال SVG قابلة للتحرير. يفيد في رسم توضيحي أو شارة أو مفهوم حروفي يحتاج إلى ملف عمل متجهي لإجراء تعديلات تصميمية لاحقًا.

رمز النموذج الدقيق هو recraftv4_pro_vector. وهو مختلف عن V4 Vector القياسي ونموذج V4 Pro النقطي وعائلة V4.1 اللاحقة. ينص مرجع الأحجام من الجهة المنتجة على أن جميع النماذج المتجهية تقبل أربع عشرة نسبة أبعاد بوصفها نسب العرض إلى الارتفاع، وأن مخرجات SVG ليس لها حجم بكسلي ثابت. لذلك لا تمثل الأبعاد النقطية 2048 × 2048 الخاصة بـV4 Pro حدًا للدقة البكسلية لهذا الإصدار. اختر التكوين المقصود وشكل الأصل بدلًا من تسمية حجم نقطي.

تؤكد إرشادات V4 من الشركة المصنّعة المنطق الرسومي المسطّح في أعمال المتجهات والشعارات. صِف نوع الرسم والهندسة والشكل الظلي وانضباط الخطوط ولوحة الألوان والتخطيط. ولشارة ميناء، اطلب رسمًا مفصّلًا بشكل ظلي مدمج لمنارة، وشكل موجة كبير، وفراغات داخلية واسعة، ولونين مسطّحين. حدّد العنصر الذي ينبغي أن يهيمن والتفاصيل التي ينبغي أن تبقى ثانوية. يكون الوصف البنيوي أنفع لنتيجة متجهية قابلة للتحرير من ملمس فوتوغرافي أو لغة تصف الخامات عندما ينبغي أن يظل التصميم مسطّحًا.

يدعم مرجع التوليد الحالي لهذا الإصدار بالضبط موجّهات تصل إلى 10,000 حرف، ومن مخرج واحد إلى ستة مخرجات، وبذرة عشوائية، وإعدادات للألوان المفضّلة أو لون الخلفية. يمكن للأساليب المخصصة المتوافقة والصور المرجعية الاختيارية تثبيت معالجة بصرية متكررة. تتيح المطابقة المرنة قراءة أكثر حرية، وتتبع المطابقة الدقيقة الأسلوب بصورة أوثق. استخدم مراجع متسقة بصريًا واجعل النظام اللوني المقصود صريحًا؛ فالألوان المرجعية الدقيقة غير مضمونة. للتوليد بأسلوب مرجعي، استخدم من صورة واحدة إلى عشر صور بصيغة PNG أو JPG أو WebP، بإجمالي لا يتجاوز 64 MB وأقل من 20 MB لكل صورة. يجب ألا يقل أقصر ضلع لكل مرجع عن 256 بكسل، وألا يزيد أطول ضلع عن 4,096 بكسل، وألا تتجاوز الدقة 16 ميغابكسل. استخدم إما هذه المراجع أو أسلوبًا محفوظًا متوافقًا، دون الجمع بينهما.

توثّق Recraft التحويل من صورة إلى صورة لنماذج V4 النقطية والمتجهية. قدّم صورة موجودة وصِف التغيير المطلوب، مع strength من 0 إلى 1 لتحديد مدى ابتعاد النتيجة المولّدة عن المصدر. يعيد النموذج المتجهي SVG. لا تقبل هذه العملية إعدادات أسلوب V4، لذا تختلف عن إنشاء رسم جديد بمرجع أسلوبي. تسمح متطلبات إدخال الصور فيها بصيغ PNG أو JPG أو WebP أو SVG بأقل من 20 MB وحتى 16 MP، مع أضلاع بين 256 و4096 بكسل.

لا يدعم V4 إعدادات V3 التالية: negative_prompt وأسماء الأساليب المنسّقة وtext_layout وartistic_level وno_text. تصف إرشادات الشركة المصنّعة عبارات قصيرة ومتوسطة الطول مقروءة عند تحديد التسلسل الهرمي، لكن الطباعة الدقيقة ما زالت تحتاج إلى فحص في SVG المكتمل. تحقّق من الشكل الظلي والحروف والمناطق اللونية والتفاصيل الدقيقة بالحجم المقصود، ثم أعد تشكيل الأصل أو تلوينه حسب متطلبات التصميم. هذا إصدار لتوليد متجهات مفصّلة، وله مخرجاته وإعداداته الخاصة بدلًا من خصائص نموذج Pro النقطي.

عبر Ailoot، اختر معرّف هذا النموذج بالضبط في /v1/images/generations وقدّم الموجّه الإبداعي. احتفظ بكل عنصر data معاد، سواء حملت الاستجابة عنوان URL أو محتوى صورة مرمّزًا، واحفظ البايتات الفعلية مع نوع المحتوى المعاد لها. احتفظ ببيانات usage وأي task_id للوسائط مع الأصل، ثم راجع أشكاله وحروفه ومناطقه اللونية ضمن التصميم المقصود.

Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-pro-vector

recraft/recraft-v4-pro-vector

أخرى /recraft/recraft-v4-pro-vector

البداية

المدخلات المقبولة: النص · الصور
النتائج: الصور

متاح في Ailoot · المدخلات والطرائق

Ailoot Ultra · Images POST /v1/images/generations

الإدخال: text, image
الإخراج: image
صيغة الإخراج: ملف صورة

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود recraft/recraft-v4-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

curl · أنشئ مرة واحدة واحتفظ بالنتيجة كاملة

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-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/assets
GET /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-pro-vector

الأسماء البديلة لمسارات الطرائق

استخدم مسارات الطرائق المعروضة أعلاه.

معرّفات النماذج ذات الصلة IDs

recraft/recraft-v4-pro-vector

FAQ · Recraft: Recraft V4 Pro Vector

ما المدخلات والنتائج المتاحة؟: POST /v1/images/generations · recraft/recraft-v4-pro-vector: text, image → image
ما الحقول التي يستخدمها الطلب؟: POST /v1/images/generations · recraft/recraft-v4-pro-vector: model, prompt, n, aspect_ratio, output_format, input_references, quality
ما الحدود المطبقة؟: POST /v1/images/generations · recraft/recraft-v4-pro-vector: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4 Pro Vector