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

پیگیری وضعیت

بعد از ثبت درخواست، با taskId می‌توانید ببینید تولید تصویر در چه مرحله‌ای قرار دارد.

مسیر درخواست

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

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

هر ۲ تا ۵ ثانیه یک بار این مسیر را صدا بزنید. وقتی status به completed برسد، تصویرها آماده‌اند. اگر وضعیت failed بود، مقدار error را بررسی کنید.

وضعیت‌ها

  • pending / processing: درخواست در صف یا در حال پردازش است
  • completed: درخواست موفق بوده و فیلد images شامل URL تصویرهاست
  • failed: درخواست ناموفق بوده و دلیل خطا در error آمده است
json
1{
2  "id": "task_abc123",
3  "status": "completed",
4  "model": "nano-banana-2",
5  "prompt": "شهری آینده‌نگر در غروب",
6  "images": ["https://..."],
7  "error": null,
8  "credits_reserved": 8,
9  "credits_deducted": true,
10  "created_at": "2026-07-04T12:00:00.000Z",
11  "completed_at": "2026-07-04T12:00:45.000Z"
12}

نکته

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