الفيديو والمواد
سرد المهام (متوافق مع Volc)
سرد مهام توافق Seedance الأخيرة للمؤسسة الحالية.
نظرة عامة
سرد مهام التوافق الخاصة بالمؤسسة الموثقة باستخدام مفتاح TokenLab Bearer API. يتم سرد المهام التي تم إنشاؤها فقط من خلال نقطة النهاية المتوافقة مع Volc. بدون filter.task_ids، تغطي النتائج المهام من الأيام السبعة الماضية؛ بينما يؤدي توفير معرفات دقيقة إلى الاستعلام عن تلك المهام مباشرة.
راجع أيضاً نماذج فيديو Seedance 2.0 و توليد الفيديو.
السرد والفلاتر
page_num: الافتراضي1، عدد صحيح من1إلى500.page_size: الافتراضي20، عدد صحيح من1إلى500.filter.status:queued،running،succeeded،failed،cancelled،expired.filter.task_ids: كرر هذا المعامل لمعرفات مهام متعددة دقيقة؛ لا تقم بدمجها بفواصل.filter.model: قيمةmodelالتي تم إرسالها عند إنشاء المهمة.filter.service_tier:default،flex.
تحتوي الاستجابة على items (الصفحة المطلوبة) و total (جميع المهام التي تطابق الفلاتر). يستخدم كل عنصر شكل استجابة get-task. يؤدي استخدام معامل غير مدعوم أو قيمة خارج النطاق إلى إرجاع 400. استخدم نقطة نهاية get لتحديث حالة مهمة معروفة.
مثال
curl "https://api.tokenlab.sh/api/v3/contents/generations/tasks?page_num=1&page_size=20&filter.status=succeeded" \
-H "Authorization: Bearer $TOKENLAB_API_KEY"curl "https://api.tokenlab.sh/api/v3/contents/generations/tasks?filter.task_ids=cgt-20260102030405-a1b2c" \
-H "Authorization: Bearer $TOKENLAB_API_KEY"curl -X GET "https://example.com/api/v3/contents/generations/tasks"{ "items": [ { "id": "string", "model": "string", "status": "queued", "content": { "video_url": "http://example.com", "last_frame_url": "http://example.com" }, "seed": 0, "resolution": "string", "ratio": "string", "duration": "string", "frames": 0, "framespersecond": 0, "generate_audio": true, "tools": { "type": "web_search" }, "safety_identifier": "string", "draft": true, "draft_task_id": "string", "service_tier": "string", "execution_expires_after": 0, "usage": { "completion_tokens": 0, "total_tokens": 0, "tool_usage": { "web_search": 0 } }, "error": { "code": "string", "message": "string" }, "created_at": 0, "updated_at": 0 } ], "total": 0}التفويض
BearerAuth مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
معاملات الاستعلام
رقم الصفحة.
1 <= value <= 5001حجم الصفحة.
1 <= value <= 50020التصفية حسب حالة المهمة.
القيم المتاحة
- "queued"
- "running"
- "succeeded"
- "failed"
- "cancelled"
- "expired"
معرفات المهام الدقيقة. كرر filter.task_ids لمعرفات متعددة.
التصفية حسب قيمة النموذج المرسلة عند إنشاء المهمة.
التصفية حسب فئة الخدمة.
القيم المتاحة
- "default"
- "flex"
الاستجابة
application/json
application/json
application/json
application/json