Documentation menu
AI Studio API

Task status

Poll a generation task and handle queued, running, succeeded, and failed states.

API playground

Send a real request to this site and inspect the HTTP response immediately.

GET
GET

Only same-origin /api/* paths are allowed.

Leave blank to use your current signed-in browser session. The key is never saved.

Response
Send a request to view its response here.

حالات تقدم المهمة

تخبرك هذه الحالات سواء كانت العملية في انتظار، قيد التشغيل، انتهت، أو فشلت.

queued
running
succeeded
failed
GET/api/ai-studio/tasks/{taskId}

تحقق من تقدم المهمة بعد أن يُرجع الإنشاء taskId و statusSupported=true.

رؤوس الطلب

Authorization: Bearer YOUR_API_KEY

معلمات الطلب

الاسمنوعمطلوبافتراضيخياراتالوصف
taskIdstringنعم--تمت إعادة معرف المهمة بعد بدء التوليد.
طلب
curl -X GET "https://freesoragenerator.com/api/ai-studio/tasks/provider-task-id" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "success": true,
  "data": {
    "generationId": "b6a7f5c4-8a7c-4e2b-8cf6-6b8d9b3d8d21",
    "taskId": "provider-task-id",
    "modelId": "video:sora2-text-to-video-standard",
    "state": "running",
    "mediaUrls": [],
    "raw": {},
    "reservedCredits": 20,
    "refundedCredits": 0
  }
}
مثال على خطأ
{
  "success": false,
  "error": "Generation record not found"
}