API Hop

दस्तावेज़

API Hop दस्तावेज़

असिंक्रोनस जॉब प्राप्त करें

वर्तमान खाते से बनाए गए असिंक्रोनस जॉब की स्थिति और परिणाम प्राप्त करें।

GEThttps://api.apihop.ai/v1/jobs/{id}

लागू एंडपॉइंट

Seedance 2.5, POST https://api.apihop.ai/v1/video/seedance इस्तेमाल करते हैं, जो data.jobId लौटाता है; जॉब स्थिति और परिणाम के लिए GET https://api.apihop.ai/v1/jobs/{id} आवश्यक है।

एंडपॉइंट JSON या SSE से सीधे परिणाम देता है और Jobs इस्तेमाल नहीं करता।

यह एंडपॉइंट तभी इस्तेमाल करें जब निर्माण उत्तर में स्पष्ट रूप से data.jobId हो। अनुरोध में उसी खाते की API कुंजी चाहिए जिसने जॉब बनाया था।

text
GET https://api.apihop.ai/v1/jobs/{id}

प्रमाणीकरण

http
Authorization: Bearer YOUR_API_KEY

पथ पैरामीटर

idstringआवश्यक

जॉब बनाते समय jobId के रूप में लौटी संख्यात्मक जॉब ID।

अनुरोध उदाहरण

bash
curl --request GET \
  --url https://api.apihop.ai/v1/jobs/123456789012345678 \
  --header 'Authorization: Bearer YOUR_API_KEY'

उत्तर

idstring

जॉब ID।

statusstring

PENDING, CONNECT, PROCESSING, COMPLETED, FAILED या CANCELLED।

inputParamsobject

जॉब बनाते समय भेजे गए इनपुट पैरामीटर।

outputResultunknown

अंतिम आउटपुट। चित्र और वीडियो मॉडल अलग संरचनाएँ लौटाते हैं।

createdAtstring

ISO 8601 निर्माण टाइमस्टैम्प।

startedAtstring | null

ISO 8601 संसाधन शुरू होने का समय।

completedAtstring | null

ISO 8601 पूर्णता समय।

सफलता उदाहरण

json
{
  "success": true,
  "data": {
    "id": "123456789012345678",
    "status": "COMPLETED",
    "inputParams": {
      "model": "seedance-2.5",
      "prompt": "Create an eight-second brand film"
    },
    "outputResult": [
      {
        "url": [
          "https://video.example.com/generated/result.mp4"
        ]
      }
    ],
    "createdAt": "2026-08-20T08:24:00.000Z",
    "startedAt": "2026-08-20T08:24:02.000Z",
    "completedAt": "2026-08-20T08:26:30.000Z"
  },
  "requestId": "req_..."
}

पोलिंग संबंधी मार्गदर्शन

  • हर 5 से 10 सेकंड में पोल करें।
  • PENDING, CONNECT और PROCESSING अंतिम स्थितियाँ नहीं हैं।
  • COMPLETED के बाद outputResult पढ़ें।
  • FAILED या CANCELLED के बाद पोलिंग रोकें।
  • परिणाम URL समाप्त हो सकते हैं; पूरे एसेट तुरंत सहेजें।

त्रुटि उत्तर

पूरी कोड सूची, प्रोटोकॉल अंतर और निदान चरणों के लिए त्रुटि कोड और निदान देखें।

जॉब नहीं मिला:

json
{
  "success": false,
  "error": {
    "code": 30000,
    "message": "Job 123456789012345678 not found"
  },
  "requestId": "req_..."
}

दूसरे खाते का जॉब खोलना:

json
{
  "success": false,
  "error": {
    "code": 20001,
    "message": "Access denied"
  },
  "requestId": "req_..."
}