الفيديو والمواد

سرد المهام (متوافق مع Volc)

سرد مهام توافق Seedance الأخيرة للمؤسسة الحالية.

GET
/api/v3/contents/generations/tasks

نظرة عامة

سرد مهام التوافق الخاصة بالمؤسسة الموثقة باستخدام مفتاح 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
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

معاملات الاستعلام

page_num?integer

رقم الصفحة.

النطاق1 <= value <= 500
الافتراضي1
page_size?integer

حجم الصفحة.

النطاق1 <= value <= 500
الافتراضي20
filter.status?string

التصفية حسب حالة المهمة.

القيم المتاحة

  • "queued"
  • "running"
  • "succeeded"
  • "failed"
  • "cancelled"
  • "expired"
filter.task_ids?array<string>

معرفات المهام الدقيقة. كرر filter.task_ids لمعرفات متعددة.

filter.model?string

التصفية حسب قيمة النموذج المرسلة عند إنشاء المهمة.

filter.service_tier?string

التصفية حسب فئة الخدمة.

القيم المتاحة

  • "default"
  • "flex"

الاستجابة

application/json

application/json

application/json

application/json