Recraft: Recraft V4.1 Vector

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

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

عن النموذج

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

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

النسخة الدقيقة هي recraftv4_1_vector، وهي مختلفة عن recraftv4_1_pro_vector ونماذج Utility Vector. يذكر دليل الأحجام أن جميع النسخ المتجهية تقبل أربع عشرة نسبة أبعاد بوصفها نسب العرض إلى الارتفاع، وتنتج SVG دون أبعاد بكسلية ثابتة. استخدم هذه النسبة لتثبيت التكوين المطلوب، مثل أيقونة مربعة أو شعار عريض. يمكن عندئذ اختيار حجم العرض النهائي في سير عمل التصميم بدلًا من تثبيته بمخرج نقطي بحجم 1K.

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

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

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

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

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

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

recraft/recraft-v4.1-vector

أخرى /recraft/recraft-v4.1-vector

البداية

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

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

Ailoot Ultra · Images POST /v1/images/generations

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

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود recraft/recraft-v4.1-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.16 لكل صورة مُخرجة
الإعداداتتكلفة التوليد التقديرية	جدول التعرفة—	الكمية المتوقعةتقدير لتوليد واحد	وحدة الفوترة—	الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.16 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة.

تحجز 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.1-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.1-vector

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

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

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

recraft/recraft-v4.1-vector

FAQ · Recraft: Recraft V4.1 Vector

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

Recraft: Recraft V4.1 Vector