تولیدها
یک اندپوینت بررسی وضعیت (پولینگ) برای همه انواع مدیا و فهرستی از هر آنچه
ارسال کردهاید. منظور از id همان آیدیای است که در پاسخ POST ارسال
برگردانده شده است، نه آیدی پرووایدر.
فهرست تولیدها
تولیدهایی که با کلیدهای API شما ارسال شدهاند، از جدیدترین به قدیمیترین، هر کدام با همان ساختاری که اندپوینت بررسی وضعیت برمیگرداند. این درخواست از سهمیه شما کم نمیکند.
لینکهای خروجی هنگام خواندن فهرست sign میشوند و دستکم 24 ساعت معتبر میمانند.
پارامترهای query
typeفقط تولیدهای این نوع مدیا برگردانده میشوند.
statusفقط تولیدهایی برگردانده میشوند که اکنون در این وضعیتاند.
fromفقط تولیدهایی که در این زمان ISO 8601 یا پس از آن ارسال شدهاند (اگر اختلاف ساعت مشخص نشود، UTC در نظر گرفته میشود).
toفقط تولیدهایی که در این زمان ISO 8601 یا پیش از آن ارسال شدهاند (اگر اختلاف ساعت مشخص نشود، UTC در نظر گرفته میشود).
limitاندازه صفحه. مقادیر خارج از بازه 1 تا 50 به نزدیکترین مقدار داخل همین بازه تغییر میکنند.
pageشماره صفحه، از 1 شروع میشود. مقادیر کمتر از 1 برابر 1 در نظر گرفته میشوند و صفحههای بالاتر از 1000 رد میشوند.
فهرست تولیدها › پاسخها
یک صفحه از تولیدها.
از جدیدترین به قدیمیترین. تولیدی که رکوردش حذف شده باشد در فهرست نمیآید.
pageصفحهای که برگردانده شده است.
has_moreاینکه صفحه بعدی وجود دارد یا نه.
بررسی وضعیت یک تولید
وضعیت فعلی یک تولید. بررسی وضعیت از سهمیه شما کم نمیکند؛ هر چند ثانیه یک بار، فاصله مناسبی است.
فیلد output تا وقتی status برابر succeeded نشده خالی است و پس از
حذف مدیا بعد از 90 روز هم دوباره خالی میشود. ساختار آن به type بستگی
دارد؛ اسکیمای پاسخ را ببینید. لینکهای خروجی signed هستند و دستکم 24 ساعت
معتبر میمانند؛ پس بهجای نگه داشتن طولانیمدت آنها، وضعیت را دوباره
بررسی کنید.
فیلد credits_charged مقداری است که هنگام ارسال کسر شده و هرگز تغییر
نمیکند. credits_refunded مقداری است که از آن پس بازگشته است: کل مبلغ
پس از بازگشت اعتبار یک تولید failed، اعتبار ثانیههای تحویلنشده وقتی
ویدیویی با محاسبه ثانیهای دستکم 2 ثانیه کوتاهتر تحویل شود، یا بخش استفادهنشده
هزینه edit/extend در seedance25 پس از تسویه.
پارامترهای path
idهمان id که در پاسخ POST ارسال برگردانده شده است.
بررسی وضعیت یک تولید › پاسخها
وضعیت فعلی.
idtypemodelمدل، همانطور که در درخواست فرستادهاید.
statusتا وقتی پرووایدر نتیجه را برنگرداند، processing است. وضعیتهای
نهایی succeeded و failed هستند و هیچکدام پس از آن تغییر نمیکنند.
credits_chargedمقداری که هنگام ارسال کسر شده است. هرگز تغییر نمیکند.
credits_refundedمقداری که از آن پس بازگشته است: کل credits_charged پس از بازگشت
اعتبار یک تولید failed، هزینه ثانیههای تحویلنشده وقتی ویدیوی
ثانیهای دستکم 2 ثانیه کوتاهتر برگردد، یا بخش استفادهنشده رزرو
اعتبار edit/extend در seedance25 پس از تسویه. credits_charged منهای
این مقدار، هزینه واقعی تولید است.
created_atتا وضعیت succeeded خالی است. ساختار آیتمها به type بستگی دارد:
- image و video:
urlوthumbnail. ویدیو همیشه دقیقاً یک آیتم برمیگرداند. - music: دو آیتم، هر کدام با
title،url،cover_imageوduration. - speech: یک آیتم با
url.
همه لینکها signed هستند و 24 ساعت پس از ساخته شدن منقضی میشوند.
failure_reasonفقط وقتی وجود دارد که status برابر failed باشد.
| مقدار | معنی |
|---|---|
MODERATION | پرامپت یا یکی از تصویرهای ورودی توسط فیلتر ایمنی رد شد. |
COPYRIGHT | نام بردن از یک هنرمند، متن ترانه دارای حق نشر یا محتوای دیگری که صاحب حقوق دارد. |
INVALID_INPUT | یک فایل ورودی قابل استفاده نبود؛ نوع نادرست، حجم بیش از حد یا نبود سوژه قابل تشخیص. |
OUTPUT_FILTERED | مدل خروجی را ساخت، اما از برگرداندن آن خودداری کرد. |
TIMEOUT | پرووایدر تسک را بهموقع تمام نکرد. |
PROVIDER_ERROR | خطای پرووایدر هنگام ارسال یا ساخت. |
UNKNOWN | هیچ علتی ثبت نشده است. |