مدل سهبعدی
دریافت فایل سهبعدی
برای کار تمامشده، با ریدایرکت ۳۰۲ به یک لینک امضاشدهی فایل GLB یا قالب دیگری که میخواهید میفرستد. لینک یک ساعت معتبر است.
/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ریدایرکت به لینک امضاشدهی فایل GLB؛ پس از دنبال کردن، بایتهای فایل میآید.
پارامترهای مسیر
idstringالزامیشناسهی کار به شکل
job_...که هنگام ساخت گرفتید.
پارامترهای کوئری
formatstringقالب فایل. پیشفرض
glb.مقادیر مجاز:glbfbxobjusdzstlredirectstringبا مقدار
falseبهجای ریدایرکت ۳۰۲، پاسخ JSON با فیلدهایurlوmimeوexpires_inبرمیگردد. این حالت برای برنامههای مرورگری است که نمیتوانند ریدایرکت را با کلید دنبال کنند.مقادیر مجاز:false
خطاها
invalid_request400formatیکی از قالبهای شناختهشده نیست.job_not_found404چنین کاری برای این حساب وجود ندارد.
format_not_available404مدل این قالب را برای این کار نساخته است.
content_not_found404فایل این کار پاک شده است.
job_not_ready409کار هنوز تمام نشده یا شکست خورده یا لغو شده است و فایلی ندارد.