Przejdź do głównej treści
Główną funkcją Wan Tasks API jest możliwość sprawdzenia statusu wykonania zadania poprzez wprowadzenie ID zadania wygenerowanego przez Wan Videos Generation API. Dokument ten szczegółowo opisuje integrację Wan Tasks API, aby pomóc Ci łatwo zintegrować i w pełni wykorzystać potężne możliwości tego API. Dzięki Wan Tasks API możesz łatwo sprawdzić status wykonania zadań w Wan Videos Generation API.

​
Proces aplikacji

Aby korzystać z Wan Tasks API, najpierw należy przejść do strony aplikacji Wan Videos Generation API i złożyć wniosek o odpowiednią usługę, a następnie skopiować ID zadania z Wan Videos Generation API, jak pokazano na obrazku:

Na koniec przejdź do strony Tasks API Wan Tasks API i złóż wniosek o odpowiednią usługę, po wejściu na stronę kliknij przycisk „Acquire”, jak pokazano na obrazku: Strona aplikacji Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na stronę logowania, aby zarejestrować się i zalogować, po zalogowaniu lub rejestracji automatycznie wrócisz na bieżącą stronę. Podczas pierwszej aplikacji otrzymasz darmowy limit, który pozwala na bezpłatne korzystanie z tego API.

​
Przykład żądania

Wan Tasks API może być używane do sprawdzania wyników Wan Videos Generation API. Aby dowiedzieć się, jak korzystać z Wan Videos Generation API, zapoznaj się z dokumentem Wan Videos Generation API. Weźmy jako przykład ID zadania zwrócone przez usługę Wan Videos Generation API i pokażmy, jak używać tego API. Załóżmy, że mamy ID zadania: a4bca552-d964-46a1-8ff7-fd922f916582, a następnie pokażemy, jak to zrobić, przekazując ID zadania.

​
Przykład zadania

​
Ustawienia nagłówków żądania i ciała żądania

Nagłówki żądania obejmują:
  • accept: określa, że oczekiwany jest wynik w formacie JSON, tutaj wpisz application/json.
  • authorization: klucz do wywołania API, po złożeniu wniosku można go bezpośrednio wybrać z rozwijanej listy.
Ciało żądania obejmuje:
  • id: ID przesłanego zadania.
  • action: sposób operacji na zadaniu.
Ustawienia są pokazane na poniższym obrazku:

​
Przykład kodu

Można zauważyć, że po prawej stronie strony automatycznie wygenerowano kod w różnych językach, jak pokazano na obrazku:

Przykłady kodu są następujące:

​
CURL

curl -X POST 'https://api.acedata.cloud/wan/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "a4bca552-d964-46a1-8ff7-fd922f916582",
  "action": "retrieve"
}'

​
Python

import requests

url = "https://api.acedata.cloud/wan/tasks"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "id": "a4bca552-d964-46a1-8ff7-fd922f916582",
    "action": "retrieve"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

​
Przykład odpowiedzi

Po pomyślnym żądaniu API zwróci szczegółowe informacje o zadaniu wideo. Na przykład: 
{
  "_id": "6974ce81ff2676299c399252",
  "id": "a4bca552-d964-46a1-8ff7-fd922f916582",
  "api_id": "6a4ecdbf-b219-4505-8277-5ec4b1ac14f8",
  "application_id": "52933893-8e8b-4cd6-b9e5-2354eedea000",
  "created_at": 1769262721.763,
  "credential_id": "c7173d71-d234-413e-ab72-7bfa6715d12f",
  "request": {
    "action": "text2video",
    "model": "wan2.6-t2v",
    "prompt": "Astronauts shuttle from space to volcano",
    "duration": 5
  },
  "trace_id": "b9cf9569-4010-46b1-80ec-efc881126eac",
  "type": "videos",
  "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
  "job_id": "0d2042f9-ba8d-496d-8ab5-182617e28f9e",
  "response": {
    "success": true,
    "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/1d/db/20260124/da477ba2/0d2042f9-ba8d-496d-8ab5-182617e28f9e.mp4?Expires=1769349278&OSSAccessKeyId=LTAI5tKPD3TMqf2Lna1fASuh&Signature=SjBa4wRcDVx3SSYu%2Fx7BYCFQk0s%3D",
    "state": "completed",
    "task_id": "a4bca552-d964-46a1-8ff7-fd922f916582"
  },
  "duration": 787.3310000896454,
  "finished_at": 1769263509.094
}
Wynik zwrotny zawiera wiele pól, pole request to ciało żądania, które zostało wysłane podczas inicjowania zadania, a pole response to ciało odpowiedzi zwrócone po zakończeniu zadania. Opis pól jest następujący.
  • id, ID zadania wideo, które zostało wygenerowane, służy do unikalnej identyfikacji tego zadania generowania wideo.
  • request, informacje o żądaniu w zadaniu wideo.
  • response, informacje o odpowiedzi w zadaniu wideo.

​
Operacje zbiorcze

To jest zapytanie o szczegóły zadań wideo dla wielu ID zadań, w przeciwieństwie do powyższego, należy wybrać akcję jako retrieve_batch. Ciało żądania obejmuje:
  • ids: tablica ID przesłanych zadań.
  • action: sposób operacji na zadaniu.
Ustawienia są pokazane na poniższym obrazku:

​
Przykład kodu

Można zauważyć, że po prawej stronie strony automatycznie wygenerowano kod w różnych językach, jak pokazano na obrazku:

Przykłady kodu są następujące:

​
Przykład odpowiedzi

Po pomyślnym żądaniu API zwróci szczegółowe informacje o wszystkich zadaniach wideo w partii. Na przykład: 
{
  "items": [
    {
      "_id": "6974ce81ff2676299c399252",
      "id": "a4bca552-d964-46a1-8ff7-fd922f916582",
      "api_id": "6a4ecdbf-b219-4505-8277-5ec4b1ac14f8",
      "application_id": "52933893-8e8b-4cd6-b9e5-2354eedea000",
      "created_at": 1769262721.763,
      "credential_id": "c7173d71-d234-413e-ab72-7bfa6715d12f",
      "request": {
        "action": "text2video",
        "model": "wan2.6-t2v",
        "prompt": "Astronauci przelatują z kosmosu do wulkanu",
        "duration": 5
      },
      "trace_id": "b9cf9569-4010-46b1-80ec-efc881126eac",
      "type": "videos",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "job_id": "0d2042f9-ba8d-496d-8ab5-182617e28f9e",
      "response": {
        "success": true,
        "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/1d/db/20260124/da477ba2/0d2042f9-ba8d-496d-8ab5-182617e28f9e.mp4?Expires=1769349278&OSSAccessKeyId=LTAI5tKPD3TMqf2Lna1fASuh&Signature=SjBa4wRcDVx3SSYu%2Fx7BYCFQk0s%3D",
        "state": "completed",
        "task_id": "a4bca552-d964-46a1-8ff7-fd922f916582"
      },
      "duration": 787.3310000896454,
      "finished_at": 1769263509.094
    },
    {
      "_id": "6974ce81ff2676299c399252",
      "id": "a4bca552-d964-46a1-8ff7-fd922f916582",
      "api_id": "6a4ecdbf-b219-4505-8277-5ec4b1ac14f8",
      "application_id": "52933893-8e8b-4cd6-b9e5-2354eedea000",
      "created_at": 1769262721.763,
      "credential_id": "c7173d71-d234-413e-ab72-7bfa6715d12f",
      "request": {
        "action": "text2video",
        "model": "wan2.6-t2v",
        "prompt": "Astronauci przelatują z kosmosu do wulkanu",
        "duration": 5
      },
      "trace_id": "b9cf9569-4010-46b1-80ec-efc881126eac",
      "type": "videos",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "job_id": "0d2042f9-ba8d-496d-8ab5-182617e28f9e",
      "response": {
        "success": true,
        "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/1d/db/20260124/da477ba2/0d2042f9-ba8d-496d-8ab5-182617e28f9e.mp4?Expires=1769349278&OSSAccessKeyId=LTAI5tKPD3TMqf2Lna1fASuh&Signature=SjBa4wRcDVx3SSYu%2Fx7BYCFQk0s%3D",
        "state": "completed",
        "task_id": "a4bca552-d964-46a1-8ff7-fd922f916582"
      },
      "duration": 787.3310000896454,
      "finished_at": 1769263509.094
    }
  ],
  "count": 2
}

​
CURL

curl -X POST 'https://api.acedata.cloud/wan/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["a4bca552-d964-46a1-8ff7-fd922f916582","a4bca552-d964-46a1-8ff7-fd922f916582"],
  "action": "retrieve_batch"
}'

​
Błąd obsługi

W przypadku wystąpienia błędu podczas wywoływania API, API zwróci odpowiedni kod błędu i informacje. Na przykład:
  • 400 token_mismatched：Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
  • 400 api_not_implemented：Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
  • 401 invalid_token：Nieautoryzowany, nieprawidłowy lub brakujący token autoryzacji.
  • 429 too_many_requests：Zbyt wiele żądań, przekroczono limit szybkości.
  • 500 api_error：Błąd wewnętrzny serwera, coś poszło nie tak na serwerze.

​
Przykład odpowiedzi błędu

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "pobieranie nie powiodło się"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
Wnioski

Dzięki temu dokumentowi zrozumieliście, jak używać API Wan Tasks do zapytań o szczegółowe informacje o pojedynczych lub zbiorczych zadaniach wideo. Mamy nadzieję, że ten dokument pomoże Wam lepiej zintegrować i korzystać z tego API. W razie jakichkolwiek pytań, prosimy o kontakt z naszym zespołem wsparcia technicznego.