رفتن به محتوا

Tripo3D · Image to 3D

یکپارچه‌سازی

شناسه مدل tripo3d/tripo/v2.5/image-to-3d
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/tripo3d/tripo/v2.5/image-to-3d?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

فایل‌هایی مانند نمونه: ⁨‎$۰٫۳۰⁩ ۳۰۰ اعتبار API · ≈ ⁨‎₽۳۲٫۲۷⁩ فایل‌های شما پیش از اجرا اندازه‌گیری می‌شوند اجرای آن در این صفحه

دریافت کلید API
Tripo تصویر به 3D #image-to-3d#stylized

تبدیل تصویر به سه‌بعدی (v2.5) با پیش‌تنظیم‌های سبک، بافت‌گذاری HD، خروجی quad و گزینه‌های هم‌ترازی

Tripo · 3D

اولین نتیجه شما اینجا قرار می‌گیرد

درخواست را در زیر بسازید و با کلید API خود اجرا کنید. خروجی‌ها در فضای ذخیره‌سازی ما کپی می‌شوند و برای همیشه یا به‌مدت ۷ روز رایگان نگه‌داری می‌شوند.

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

•الزامی image_url
یک فایل بیندازید، یا

URL تصویر مورد استفاده برای تولید مدل.

texture پیش‌فرض standard

تنظیم بافت مدل: 'standard' پیش‌فرض است، 'no' بافت‌ها را غیرفعال می‌کند و 'HD' بافت‌های وضوح‌بالا تولید می‌کند.

تنظیم سبک؛ برای حفظ ظاهر و سبک اصلی، آن را مشخص نکنید.

پیشرفته texture_alignment · orientation · face_limit · seed · texture_seed · pbr · auto_size
texture_alignment پیش‌فرض original_image

تنظیم اولویت تراز بافت برای مدل سه‌بعدی؛ در صورت ارائه‌نشدن مقدار دیگر، از original_image استفاده می‌شود.

orientation پیش‌فرض default

جهت‌گیری مدل که ابتدا روی `default` تنظیم شده است. برای چرخش خودکار و هم‌راستاسازی مدل با تصویر اصلی، `align_image` را انتخاب کنید.

سقف تعداد وجه خروجی که در صورت ارائه‌نکردن حد صریح، به‌صورت تطبیقی انتخاب می‌شود.

Seed عددی کنترل‌کننده تولید هندسه؛ استفاده دوباره از آن مدل‌های یکسان تولید می‌کند. در صورت حذف، مقدار تصادفی انتخاب می‌شود.

Seed تولید بافت که به‌صورت عدد صحیح ارائه می‌شود یا در صورت حذف به‌صورت تصادفی انتخاب می‌گردد. مقادیر یکسان seed بافت‌های یکسان تولید می‌کنند؛ برای تغییر بافت‌های مدل، texture_seed را تغییر دهید و seed مدل را ثابت نگه دارید.

POST /run/tripo3d/tripo/v2.5/image-to-3d?wait=20 قیمت → ⁨‎$۰٫۳۰⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/tripo3d/tripo/v2.5/image-to-3d?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

اجرای این درخواست

کلید شما در این مرورگر باقی می‌ماند: فقط به Doitong API ارسال می‌شود و فقط در صورت فعال‌کردن گزینه «یادآوری»، در localStorage ذخیره می‌شود. دریافت کلید API

درباره Tripo3D · Image to 3D

از یک `image_url` واحد مدل سه‌بعدی تولید می‌کند. `texture` می‌تواند no، standard یا HD باشد و خروجی PBR نیز اختیاری است. پیش‌تنظیم `style` مانند clay، steampunk، gold یا ancient bronze می‌تواند ظاهر نتیجه را تغییر دهد. کنترل‌های دیگر شامل `face_limit`، `quad` (که FBX را اجباری می‌کند)، `auto_size`، `texture_alignment` و `orientation` برای هم‌ترازکردن مدل با تصویر هستند.

پارامترها

نام استاندارد یا نام بومی را ارسال کنید، نه هر دو. نام‌های استاندارد

نامنوع پیش‌فرضمجاز توضیحات
seedاختیاری
نوعinteger | null
Seed عددی کنترل‌کننده تولید هندسه؛ استفاده دوباره از آن مدل‌های یکسان تولید می‌کند. در صورت حذف، مقدار تصادفی انتخاب می‌شود.
face_limitاختیاری
نوعinteger | null
سقف تعداد وجه خروجی که در صورت ارائه‌نکردن حد صریح، به‌صورت تطبیقی انتخاب می‌شود.
pbrاختیاری
نوعboolean | null
پیش‌فرضfalse
کلید PBR: مقدار False مدلی بدون PBR تولید می‌کند، درحالی‌که True تنظیم بافت را نادیده می‌گیرد و آن را True در نظر می‌گیرد. PBR به‌طور پیش‌فرض فعال است.
textureاختیاری
نوعenum
پیش‌فرضstandard
nostandardHD
تنظیم بافت مدل: 'standard' پیش‌فرض است، 'no' بافت‌ها را غیرفعال می‌کند و 'HD' بافت‌های وضوح‌بالا تولید می‌کند.
texture_seedاختیاری
نوعinteger | null
Seed تولید بافت که به‌صورت عدد صحیح ارائه می‌شود یا در صورت حذف به‌صورت تصادفی انتخاب می‌گردد. مقادیر یکسان seed بافت‌های یکسان تولید می‌کنند؛ برای تغییر بافت‌های مدل، texture_seed را تغییر دهید و seed مدل را ثابت نگه دارید.
auto_sizeاختیاری
نوعboolean | null
پیش‌فرضfalse
کلید اندازه‌گذاری واقعی که به‌طور پیش‌فرض (False) غیرفعال است و ابعاد مدل را با استفاده از متر به‌صورت خودکار تنظیم می‌کند.
styleاختیاری
نوعenum
person:person2cartoonobject:clayobject:steampunkanimal:venomobject:barbieobject:christmasgoldancient_bronze
تنظیم سبک؛ برای حفظ ظاهر و سبک اصلی، آن را مشخص نکنید.
quadاختیاری
نوعboolean | null
پیش‌فرضfalse
حالت چهارضلعی هنگام فعال‌بودن خروجی FBX را اجباری می‌کند. اگر quad=True و face_limit مشخص نشده باشد، مقدار پیش‌فرض face_limit برابر 10000 است.
texture_alignmentاختیاری
نوعenum
پیش‌فرضoriginal_image
original_imagegeometry
تنظیم اولویت تراز بافت برای مدل سه‌بعدی؛ در صورت ارائه‌نشدن مقدار دیگر، از original_image استفاده می‌شود.
orientationاختیاری
نوعenum
پیش‌فرضdefault
defaultalign_image
جهت‌گیری مدل که ابتدا روی `default` تنظیم شده است. برای چرخش خودکار و هم‌راستاسازی مدل با تصویر اصلی، `align_image` را انتخاب کنید.
image_urlالزامی image
نوعurl · image
URL تصویر مورد استفاده برای تولید مدل.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

پارامترهای فایل یک URL عمومی https://، یک URI از نوع data: تا سقف 10 MB، یا file_url یک فایل بارگذاری‌شده را می‌پذیرند. فایل‌ها

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/tripo/v2.5/image-to-3d",
  "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": {
    "task_id": "string",
    "model_mesh": {
      "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
    },
    "base_model": {
      "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
    },
    "pbr_model": {
      "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
    },
    "rendered_image": {
      "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
    }
  },
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
فایل‌های شما، انتخاب شماهر outputs[].url کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
task_id
stringشناسه وظیفه تولید مدل سه‌بعدی.
model_mesh
object {url, content_type, file_name, file_size} | nullخروجی مدل.
base_model
object {url, content_type, file_name, file_size} | nullخروجی مدل پایه.
pbr_model
object {url, content_type, file_name, file_size} | nullخروجی مدل PBR.
rendered_image
object {url, content_type, file_name, file_size} | nullتصویر پیش‌نمایش مدل.

مدل‌های بیشتر: تصویر به 3D

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/tripo3d/tripo/v2.5/image-to-3d.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt