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