مدل سه‌بعدی

دریافت فایل سه‌بعدی

برای کار تمام‌شده، با ریدایرکت ۳۰۲ به یک لینک امضاشده‌ی فایل GLB یا قالب دیگری که می‌خواهید می‌فرستد. لینک یک ساعت معتبر است.

GET/v1/3d/{id}/content

این مسیر خودِ فایل را در پاسخ نمی‌فرستد، بلکه با 302 به یک لینک امضاشده هدایت می‌کند که یک ساعت اعتبار دارد و فایل را به صورت دانلود می‌دهد. ابزارهایی که ریدایرکت را دنبال می‌کنند (در curl با -L) فایل را می‌گیرند. لینک امضاشده نیازی به کلید API ندارد.

بدون format فایل GLB را می‌گیرید. قالب‌های دیگر فقط وقتی هستند که در output.formats آمده باشند؛ قالبی که مدل نساخته 404 format_not_available است.

قبل از پایان کار 409 job_not_ready می‌گیرید. اگر فایل پس از پایان با DELETE پاک شده باشد، 404 content_not_found می‌گیرید. این مسیر رایگان است.

نمونه‌ها

curl https://1ai.ir/v1/3d/job_4Rw8xTq2NcYv6KpHm3Zs9B/content \
  -H "Authorization: Bearer $ONEAI_API_KEY" \
  --output model.glb
302پاسخ

ریدایرکت به لینک امضاشده‌ی فایل GLB؛ پس از دنبال کردن، بایت‌های فایل می‌آید.

پارامترهای مسیر

  • idstringالزامی

    شناسه‌ی کار به شکل job_... که هنگام ساخت گرفتید.

پارامترهای کوئری

  • formatstring

    قالب فایل. پیش‌فرض glb.

    مقادیر مجاز:glbfbxobjusdzstl
  • redirectstring

    با مقدار false به‌جای ریدایرکت ۳۰۲، پاسخ JSON با فیلدهای url و mime و expires_in برمی‌گردد. این حالت برای برنامه‌های مرورگری است که نمی‌توانند ریدایرکت را با کلید دنبال کنند.

    مقادیر مجاز:false

خطاها

  • invalid_request400

    format یکی از قالب‌های شناخته‌شده نیست.

  • job_not_found404

    چنین کاری برای این حساب وجود ندارد.

  • format_not_available404

    مدل این قالب را برای این کار نساخته است.

  • content_not_found404

    فایل این کار پاک شده است.

  • job_not_ready409

    کار هنوز تمام نشده یا شکست خورده یا لغو شده است و فایلی ندارد.

صفحه‌های مرتبط