مدل سهبعدی
وضعیت کار سهبعدی
وضعیت، پیشرفت و در صورت پایان، مشخصات فایل و قالبهای یک کار سهبعدی را برمیگرداند. پرسیدن وضعیت رایگان است.
/v1/3d/{id}مقدار status یکی از اینهاست: queued، in_progress، completed، failed، cancelled. سه مقدار آخر پایانی هستند. هر بار که وضعیت را میپرسید، اگر کار موعد بررسی داشته باشد همان لحظه از سرویس تولید پرسیده میشود.
پس از completed، فیلد output مشخصات فایل GLB را دارد و output.formats قالبهایی را نام میبرد که میتوانید با /content بگیرید. width و height اندازهی تصویر پیشنمایش است، اگر وجود داشته باشد. در failed، فیلد error کدی کلی دارد و اعتباری کسر نشده است.
فقط کارهایی را میبینید که با همین حساب و همین فضای کاری از طریق API ساختهاید. شناسهی کار دیگری یا کاری از نوع دیگر 404 job_not_found است.
نمونهها
curl https://1ai.ir/v1/3d/job_4Rw8xTq2NcYv6KpHm3Zs9B \
-H "Authorization: Bearer $ONEAI_API_KEY"{
"id": "job_4Rw8xTq2NcYv6KpHm3Zs9B",
"object": "3d.generation",
"model": "tripo/h3",
"status": "in_progress",
"progress": 40,
"created_at": 1795300000,
"completed_at": null,
"prompt": "a small red ceramic teapot",
"preset": "textured",
"detail": null,
"estimated_credits": 6,
"credits": 0,
"output": null,
"error": null
}پارامترهای مسیر
idstringالزامیشناسهی کار به شکل
job_...که هنگام ساخت گرفتید.
خطاها
job_not_found404چنین کاری برای این حساب وجود ندارد، یا از نوع سهبعدی نیست.
صفحههای مرتبط
- ساخت مدل سهبعدیاز یک توضیح متنی یا یک عکس از جسم، مدل سهبعدی GLB میسازد. پاسخ ۲۰۲ با شناسهی کار است و هزینه برای هر ساخت ثابت است.
- دریافت فایل سهبعدیبرای کار تمامشده، با ریدایرکت ۳۰۲ به یک لینک امضاشدهی فایل GLB یا قالب دیگری که میخواهید میفرستد. لینک یک ساعت معتبر است.
- حذف یا لغو کار سهبعدیکار در حال اجرا را لغو و اعتبار رزروشده را آزاد میکند؛ کار تمامشده را با همهی قالبهایش پاک میکند.