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

الحصول على مهمة (متوافقة مع Volc)

الحصول على مهمة متوافقة مع Seedance باستخدام معرف مهمة cgt الخاص بها.

GET
/api/v3/contents/generations/tasks/{id}

نظرة عامة

استخدم معرف cgt-... الذي تم إرجاعه عند الإنشاء. قم بإجراء استطلاع (Poll) كل بضع ثوانٍ طالما أن المهمة في حالة queued أو running. توقف عندما تصبح المهمة succeeded أو failed أو cancelled أو expired.

لا تقم بإعادة استخدام enum المهام الموحد v1 أو هيكل الاستجابة هنا. يستخدم /v1/tasks/{id} حالات pending و processing و completed و failed؛ بينما تستخدم نقطة النهاية v3 هذه الـ enum الرسمي المذكور أعلاه. في كائن JSON الخاص بـ v3، يكون duration عبارة عن سلسلة نصية (string) عند وجوده، و error اختياري ويحتوي على تفاصيل الخطأ عند توفرها. يجب على عميل Go الصارم تعريف Duration كـ string مع وسم JSON duration,omitempty، والتوقف عند كل حالة نهائية في v3.

انظر أيضاً نماذج فيديو Seedance 2.0 و توليد الفيديو.

قيم الحالة

  • queued: تم قبول المهمة وهي بانتظار التشغيل.
  • running: عملية التوليد قيد التنفيذ.
  • succeeded: النتيجة جاهزة و content.video_url موجود.
  • failed: فشل التوليد؛ افحص error.code و error.message.
  • cancelled: تم إلغاء المهمة قبل اكتمالها.
  • expired: انتهت صلاحية المهمة قبل اكتمالها.

حقول الاستجابة

  • id: معرف مهمة التوافق، يبدأ بـ cgt-.
  • model: قيمة model التي أرسلتها عند إنشاء المهمة.
  • status: إحدى قيم الحالة المذكورة أعلاه.
  • content.video_url: رابط الفيديو النهائي عند النجاح. هو رابط نتيجة من TokenLab يظل صالحاً لمدة 30 يوماً؛ انظر الاحتفاظ بالبيانات.
  • content.last_frame_url: موجود فقط عند طلبه وتوفره.
  • usage: completion_tokens و total_tokens عند توفرهما، بالإضافة إلى tool_usage.web_search عند تشغيل أداة البحث على الويب.
  • created_at و updated_at: طوابع زمنية بنظام Unix بالثواني.
  • error: { code, message } عند توفر تفاصيل الخطأ. لا تستنتج وجوده بناءً على status فقط.
  • يتم تكرار قيم الطلب المحددة للمهمة عند توفرها: seed و resolution و ratio و duration (سلسلة نصية) و generate_audio و service_tier و execution_expires_after و safety_identifier و tools و draft و draft_task_id و frames و framespersecond.

لا تضيف الاستجابة أبداً حقول TokenLab مثل progress أو return_last_frame أو watermark أو priority أو camera_fixed.

يُرجع معرف المهمة غير المعروف أو منتهي الصلاحية 404؛ بينما يُرجع المعرف الذي ينتمي إلى مؤسسة أخرى 403.

مثال

curl https://api.tokenlab.sh/api/v3/contents/generations/tasks/cgt-20260102030405-a1b2c \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"
{
  "id": "cgt-20260102030405-a1b2c",
  "model": "seedance-2.0",
  "status": "succeeded",
  "content": {
    "video_url": "https://api.tokenlab.sh/v1/media-results/3f2b8c1e-6d4a-4e9b-8a7c-2d5e1f0b9c4a.mp4?token=…"
  },
  "usage": {
    "completion_tokens": 123456
  }
}
Go
type SeedanceTask struct {
    ID       string `json:"id"`
    Status   string `json:"status"`
    Duration string `json:"duration,omitempty"`
}

func isTerminal(status string) bool {
    switch status {
    case "succeeded", "failed", "cancelled", "expired":
        return true
    default:
        return false
    }
}
curl -X GET "https://example.com/api/v3/contents/generations/tasks/string"
{  "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}

التفويض

BearerAuth
AuthorizationBearer <token>

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

الموضع: header

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

id*string

معرف مهمة التوافق الذي تم إرجاعه بواسطة نقطة نهاية الإنشاء. تبدأ المعرفات بـ cgt-.

الاستجابة

application/json

application/json

application/json

application/json

application/json

application/json