مدل سه‌بعدی

وضعیت کار سه‌بعدی

وضعیت، پیشرفت و در صورت پایان، مشخصات فایل و قالب‌های یک کار سه‌بعدی را برمی‌گرداند. پرسیدن وضعیت رایگان است.

GET/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"
200پاسخ
{
  "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
}