تخطّي إلى المحتوى

Pixal3d

التكامل

معرّف النموذج pixal3d
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/pixal3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

هذا الطلب: ⁨‏0.30 $⁩ 300 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح API
Open model من صورة إلى 3D #stylized#transform

يحوّل صورة واحدة إلى نموذج GLB ثلاثي الأبعاد مزخرف مع تحكم مفصل في كل مرحلة من مراحل التوليد

Open model · 3D

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

•مطلوب image_url
أفلت ملفًا، أو

عنوان URL يشير إلى الصورة المصدر للتحويل إلى 3D.

resolution الافتراضي 1024

دقة المخرج؛ تؤدي زيادتها إلى إضافة التفاصيل لكنها تستغرق وقتاً أطول.

متقدم texture_size · ss_guidance_strength · ss_guidance_rescale · ss_sampling_steps · ss_rescale_t · shape_slat_guidance_strength · shape_slat_guidance_rescale · shape_slat_sampling_steps · shape_slat_rescale_t · tex_slat_guidance_strength · tex_slat_guidance_rescale · tex_slat_sampling_steps · tex_slat_rescale_t · mesh_scale · max_num_tokens · decimation_target · seed · remesh · enable_safety_checker
texture_size الافتراضي 2048

دقة نسيج الشبكة للخبز. تؤدي زيادة هذه الدقة إلى تفاصيل سطحية أدق وملفات أكبر.

الافتراضي 7.5

التحكم في دقة البنية ثلاثية الأبعاد الأولية: تؤدي زيادتها إلى تفضيل تطابق أقرب مع الصورة المدخلة، مع احتمال إضافة تشويش.

الافتراضي 0.7

التحكم في تشوهات التوجيه للمرحلة 1، إذ تفضّل الإعدادات المنخفضة تأثيرات توجيه أقوى، بينما تنتج الإعدادات المرتفعة مخرجاً أكثر استقراراً.

الافتراضي 12

عدد خطوات إزالة تشويش البنية الأولية: قد تؤدي الخطوات الإضافية إلى تحسين الجودة، لكنها تبطئ المعالجة.

الافتراضي 5

حدد حدة الانتقال عبر جدول ضوضاء توليد البنية: تؤدي زيادة هذه القيمة إلى جعل الانتقالات أكثر حدة.

الافتراضي 7.5

التحكم في دقة الهندسة التفصيلية: تؤدي زيادة الالتزام بالصورة المدخلة إلى إضافة التفاصيل، مع احتمال زيادة التشويش.

الافتراضي 0.5

زد هذا الإعداد عندما تبدو الهندسة مشوشة؛ فهو يقلل التشوهات الناتجة عن التوجيه القوي أثناء مرحلة الشكل.

الافتراضي 12

عدد خطوات إزالة تشويش تحسين الشكل: قد تنتج الهندسة الأكثر نعومة، لكن الخطوات الإضافية تكون على حساب السرعة.

الافتراضي 3

حدد حدة التفاصيل الهندسية عبر جدول ضوضاء تحسين الشكل؛ تؤدي زيادة هذه القيمة إلى تفاصيل أكثر حدة.

الافتراضي 1

التحكم في دقة ألوان النسيج: يؤدي الالتزام الأقرب بألوان الصورة المدخلة عند الإعدادات الأعلى إلى زيادة الحيوية، لكنه قد يسبب فرط التشبع.

الافتراضي 0

زد هذا الإعداد لمعالجة الأنسجة المشوشة أو تدرج الألوان؛ فهو يقلل التشوهات الناتجة عن التوجيه القوي أثناء مرحلة النسيج.

الافتراضي 12

عدد خطوات إزالة التشويش المستخدمة لتوليد الأنسجة. تؤدي زيادة العدد إلى وقت أطول، لكنها قد تنتج أنسجة أنظف.

الافتراضي 3

حدد حدة تفاصيل النسيج عبر جدول ضوضاء توليد النسيج؛ تؤدي زيادة هذه القيمة إلى تفاصيل أكثر حدة.

الافتراضي 1

حجّم الشبكة المستنتجة للتأثير في تقدير مسافة الكاميرا الذي يستخدمه النموذج.

الافتراضي 49152

الحد الأقصى لرموز HR لأخذ عينات الشكل المتسلسل، ما يوازن بين هندسة أدق عند الإعدادات الأعلى وتوفير الذاكرة ووقت المعالجة عند الإعدادات الأقل.

الافتراضي 200000

الهدف من تعقيد الشبكة، معبّراً عنه بعدد الرؤوس للنتيجة النهائية. يؤدي تقليل حجم الملف عبر خفض هذا الهدف إلى التضحية بالتفاصيل.

البذرة المستخدمة للتوليد العشوائي القابل لإعادة الإنتاج.

POST /run/pixal3d?wait=20 عرض السعر → ⁨‏0.30 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/pixal3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول Pixal3d

يأخذ صورة واحدة ويعيد نموذج GLB مع البذرة المستخدمة. لكل مرحلة من مراحل البنية والشكل والخامة إعدادات التوجيه وإعادة التحجيم وعدّ الخطوات وجدول الضوضاء الخاصة بها. تكون `resolution` للمخرج 1024 أو 1536، و`texture_size` هي 1024 أو 2048 أو 4096، وتحدد `decimation_target` عدد الرؤوس من 5000 إلى 1586021. تعيد `remesh` بناء الطوبولوجيا.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
image_urlمطلوب image
النوعurl · image
عنوان URL يشير إلى الصورة المصدر للتحويل إلى 3D.
seedاختياري
النوعinteger | null
البذرة المستخدمة للتوليد العشوائي القابل لإعادة الإنتاج.
resolutionاختياري
النوعenum
الافتراضي1024
10241536
دقة المخرج؛ تؤدي زيادتها إلى إضافة التفاصيل لكنها تستغرق وقتاً أطول.
ss_guidance_strengthاختياري
النوعnumber
الافتراضي7.5
0 – 10
التحكم في دقة البنية ثلاثية الأبعاد الأولية: تؤدي زيادتها إلى تفضيل تطابق أقرب مع الصورة المدخلة، مع احتمال إضافة تشويش.
ss_guidance_rescaleاختياري
النوعnumber
الافتراضي0.7
0 – 1
التحكم في تشوهات التوجيه للمرحلة 1، إذ تفضّل الإعدادات المنخفضة تأثيرات توجيه أقوى، بينما تنتج الإعدادات المرتفعة مخرجاً أكثر استقراراً.
ss_sampling_stepsاختياري
النوعinteger
الافتراضي12
1 – 50
عدد خطوات إزالة تشويش البنية الأولية: قد تؤدي الخطوات الإضافية إلى تحسين الجودة، لكنها تبطئ المعالجة.
ss_rescale_tاختياري
النوعnumber
الافتراضي5
1 – 6
حدد حدة الانتقال عبر جدول ضوضاء توليد البنية: تؤدي زيادة هذه القيمة إلى جعل الانتقالات أكثر حدة.
shape_slat_guidance_strengthاختياري
النوعnumber
الافتراضي7.5
0 – 10
التحكم في دقة الهندسة التفصيلية: تؤدي زيادة الالتزام بالصورة المدخلة إلى إضافة التفاصيل، مع احتمال زيادة التشويش.
shape_slat_guidance_rescaleاختياري
النوعnumber
الافتراضي0.5
0 – 1
زد هذا الإعداد عندما تبدو الهندسة مشوشة؛ فهو يقلل التشوهات الناتجة عن التوجيه القوي أثناء مرحلة الشكل.
shape_slat_sampling_stepsاختياري
النوعinteger
الافتراضي12
1 – 50
عدد خطوات إزالة تشويش تحسين الشكل: قد تنتج الهندسة الأكثر نعومة، لكن الخطوات الإضافية تكون على حساب السرعة.
shape_slat_rescale_tاختياري
النوعnumber
الافتراضي3
1 – 6
حدد حدة التفاصيل الهندسية عبر جدول ضوضاء تحسين الشكل؛ تؤدي زيادة هذه القيمة إلى تفاصيل أكثر حدة.
tex_slat_guidance_strengthاختياري
النوعnumber
الافتراضي1
0 – 10
التحكم في دقة ألوان النسيج: يؤدي الالتزام الأقرب بألوان الصورة المدخلة عند الإعدادات الأعلى إلى زيادة الحيوية، لكنه قد يسبب فرط التشبع.
tex_slat_guidance_rescaleاختياري
النوعnumber
الافتراضي0
0 – 1
زد هذا الإعداد لمعالجة الأنسجة المشوشة أو تدرج الألوان؛ فهو يقلل التشوهات الناتجة عن التوجيه القوي أثناء مرحلة النسيج.
tex_slat_sampling_stepsاختياري
النوعinteger
الافتراضي12
1 – 50
عدد خطوات إزالة التشويش المستخدمة لتوليد الأنسجة. تؤدي زيادة العدد إلى وقت أطول، لكنها قد تنتج أنسجة أنظف.
tex_slat_rescale_tاختياري
النوعnumber
الافتراضي3
1 – 6
حدد حدة تفاصيل النسيج عبر جدول ضوضاء توليد النسيج؛ تؤدي زيادة هذه القيمة إلى تفاصيل أكثر حدة.
mesh_scaleاختياري
النوعnumber
الافتراضي1
0.1 – 4
حجّم الشبكة المستنتجة للتأثير في تقدير مسافة الكاميرا الذي يستخدمه النموذج.
max_num_tokensاختياري
النوعinteger
الافتراضي49152
4,096 – 131,072
الحد الأقصى لرموز HR لأخذ عينات الشكل المتسلسل، ما يوازن بين هندسة أدق عند الإعدادات الأعلى وتوفير الذاكرة ووقت المعالجة عند الإعدادات الأقل.
decimation_targetاختياري
النوعinteger
الافتراضي200000
5,000 – 1,586,021
الهدف من تعقيد الشبكة، معبّراً عنه بعدد الرؤوس للنتيجة النهائية. يؤدي تقليل حجم الملف عبر خفض هذا الهدف إلى التضحية بالتفاصيل.
texture_sizeاختياري
النوعenum
الافتراضي2048
102420484096
دقة نسيج الشبكة للخبز. تؤدي زيادة هذه الدقة إلى تفاصيل سطحية أدق وملفات أكبر.
remeshاختياري
النوعboolean
الافتراضيtrue
إعادة بناء طوبولوجيا الشبكة، ما يفيد عادةً الاستخدام اللاحق بإنشاء مثلثات أنظف، على حساب زيادة وقت المعالجة.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكن تخفيف الفحص بضبط القيمة على false، شريطة أن يكون المستدعي مخولًا بذلك.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "pixal3d",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "seed": 42
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
model_glb
object {url, content_type, file_name, file_size}نموذج 3D مُولّد بتنسيق GLB.
seed
integerقيمة البذرة المستخدمة فعلياً.

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/pixal3d.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt