رفتن به محتوای اصلی
بنانا AI
GET

پیگیری وضعیت

پس از ثبت درخواست، وضعیت آن را با شناسه تسک پیگیری کنید. اگر شناسه را در اختیار ندارید، فهرست تسک‌های API حساب را بازیابی کنید.

پیگیری یک تسک

GEThttps://bananaai.ir/api/v1/tasks/:id

پارامتر مسیر، همان مقدار فیلد id در پاسخ ایجاد تسک است. پاسخ JSON شامل فیلدهایی مانند taskId یا task_id نیست.

bash
curl "https://bananaai.ir/api/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer ba_live_your_api_key"

فهرست تسک‌ها

GEThttps://bananaai.ir/api/v1/tasks

این مسیر فقط تسک‌های ایجادشده با API را برمی‌گرداند و شامل درخواست‌های پنل نمی‌شود. برای دریافت صفحه بعد، id آخرین آیتم را در starting_after بفرستید.

  • limit (اختیاری): از ۱ تا ۱۰۰، مقدار پیش‌فرض ۲۰
  • status (اختیاری): pending / processing / completed / failed
  • type (اختیاری): image / video / audio
  • created_after / created_before (اختیاری): ISO 8601
  • starting_after (اختیاری): id آخرین آیتم در صفحه قبل
bash
curl "https://bananaai.ir/api/v1/tasks?limit=20&type=video&created_after=2026-08-11T00:00:00.000Z" \
  -H "Authorization: Bearer ba_live_your_api_key"
json
1{
2  "data": [
3    {
4      "id": "task_abc123",
5      "status": "completed",
6      "type": "video",
7      "model": "grok-imagine-video",
8      "prompt": "...",
9      "images": [],
10      "videos": ["https://..."],
11      "error": null,
12      "credits_reserved": 144,
13      "credits_deducted": true,
14      "created_at": "2026-08-11T07:34:26.000Z",
15      "completed_at": "2026-08-11T07:36:01.000Z"
16    }
17  ],
18  "has_more": true
19}

بررسی دوره‌ای

هر ۳ تا ۵ ثانیه یک‌بار، مسیر دریافت یک تسک را فراخوانی کنید. وقتی status به completed برسد، نتیجه آماده است. اگر وضعیت failed بود، مقدار error را بررسی کنید. برای تکرار امن درخواست پس از پایان زمان انتظار، Idempotency-Key را ببینید.

وضعیت‌ها

  • pending / processing: درخواست در صف یا در حال پردازش است.
  • completed: درخواست موفق بوده و فیلد images یا videos شامل URL خروجی است.
  • failed: درخواست ناموفق بوده و دلیل خطا در error ثبت شده است.
json
1{
2  "id": "task_abc123",
3  "status": "completed",
4  "type": "video",
5  "model": "seedance-2",
6  "prompt": "A cinematic drone shot...",
7  "images": [],
8  "videos": ["https://..."],
9  "error": null,
10  "credits_reserved": 250,
11  "credits_deducted": true,
12  "created_at": "2026-07-11T12:00:00.000Z",
13  "completed_at": "2026-07-11T12:01:20.000Z"
14}

نکته

اگر پردازش بیش از حد طول بکشد، درخواست پس از حدود ۱۵ دقیقه ناموفق خواهد شد. در این حالت، اعتباری از حساب شما کسر نمی‌شود.
پیگیری و فهرست تسک‌ها در API