Hailuo Tasks API:s integration och användning

Hailuo Tasks API:s huvudsakliga funktion är att genom att ange det uppdrag ID som genererats av Hailuo Videos Generation API för att kontrollera statusen för det uppdraget. Detta dokument kommer att detaljerat beskriva Hailuo Tasks API:s integrationsanvisningar, för att hjälpa dig att enkelt integrera och fullt utnyttja denna APIs kraftfulla funktioner. Genom Hailuo Tasks API kan du enkelt kontrollera statusen för uppdrag som utförs av Hailuo Videos Generation API.

Ansökningsprocess

För att använda Hailuo Videos Generation API, börja med att gå till Ace Data Cloud-konsolen för att hämta din API-token, som du kan spara för framtida bruk.

Om du inte har loggat in eller registrerat dig, kommer du automatiskt att omdirigeras till inloggningssidan där du uppmanas att registrera dig och logga in, och efter att ha slutfört detta kommer du automatiskt att återvända till den aktuella sidan. En API-token räcker för att anropa alla tjänster på plattformen, du behöver inte ansöka separat för varje tjänst. Första ansökan ger en gratis kvot, så att du kan prova gratis; när kvoten är slut kan du ladda på allmänna saldot i konsolen.

📘 Fullständig dokumentation: Hailuo Videos Generation API →

Begärningsexempel

Hailuo Tasks API kan användas för att kontrollera resultaten från Hailuo Videos Generation API. För information om hur man använder Hailuo Videos Generation API, se dokumentationen Hailuo Videos Generation API. Vi tar ett exempel med ett uppdrag ID som returnerats av Hailuo Videos Generation API, för att demonstrera hur man använder denna API. Anta att vi har ett uppdrag ID: 58cc618b-9639-4ee7-add2-d2fcf260d9a3, och vi visar hur man gör detta genom att ange ett uppdrag ID.

Uppdragsexempelbild

Ställ in begärningshuvuden och begärningskropp

Begärningshuvuden inkluderar:

accept: anger att du tar emot svar i JSON-format, här anges som application/json.
authorization: nyckeln för att anropa API:t, som kan väljas direkt efter ansökan.

Begärningskropp inkluderar:

id: det uppladdade uppdrag ID:t.
action: hur uppdraget ska hanteras.

Inställningarna ser ut som på bilden nedan:

Kodexempel

Det kan noteras att olika språkets kod redan har genererats automatiskt på högra sidan, som visas på bilden:

Några kodexempel är som följer:

CURL

curl -X POST 'https://api.acedata.cloud/hailuo/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "58cc618b-9639-4ee7-add2-d2fcf260d9a3",
  "action": "retrieve"
}'

Python

import requests

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

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

payload = {
    "id": "58cc618b-9639-4ee7-add2-d2fcf260d9a3",
    "action": "retrieve"
}

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

Svarsexempel

Vid en lyckad begäran kommer API:t att returnera detaljerad information om videouppdraget här. Till exempel:

{
  "_id": "67866dff550a4144a5867aa7",
  "id": "58cc618b-9639-4ee7-add2-d2fcf260d9a3",
  "api_id": "d5af91f6-a7ec-4015-b0a5-d25051158470",
  "application_id": "2f9f4d93-9193-4c49-a1a5-eddf0ff38abb",
  "created_at": 1736863231.588,
  "started_at": 1736863231.648,
  "finished_at": 1736863300.748,
  "elapsed": 69.1,
  "credential_id": "f634e655-012e-432e-92a8-a87e4a80d636",
  "request": {
    "action": "generate",
    "prompt": "Internal heat"
  },
  "trace_id": "0c1f9f13-0aef-4d9a-a9d2-1d27055ff190",
  "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
  "response": {
    "success": true,
    "task_id": "58cc618b-9639-4ee7-add2-d2fcf260d9a3",
    "trace_id": "0c1f9f13-0aef-4d9a-a9d2-1d27055ff190",
    "data": [
      {
        "id": "2a1tbgnjdxrg80cmcmes19s33r",
        "model": "minimax-t2v",
        "prompt": "Internal heat",
        "first_image_url": null,
        "video_url": "https://platform.cdn.acedata.cloud/czjl/tjU3QYKgU96IJFgpL0eMfBFhmy0qXz9Y05P2IBhShCYaDCFUA/tmp5uligw3a.output.mp4",
        "state": "succeeded"
      }
    ]
  }
}

Det returnerade resultatet innehåller flera fält, där request-fältet är begärningskroppen som skickades vid uppdraget, medan response-fältet är svaret som returnerades efter att uppdraget slutförts. Fälten beskrivs nedan.

id, ID:t för att generera detta videouppdrag, används för att unikt identifiera detta videoproduktionsuppdrag.
request, begärningsinformationen för videouppdraget.
response, svarsinformationen för videouppdraget.
created_at, tidpunkten då uppdraget skapades, Unix-tidsstämpel (sekunder, flyttal).
started_at, tidpunkten då uppdraget började utföras, Unix-tidsstämpel (sekunder, flyttal).
finished_at, tidpunkten då uppdraget slutfördes, Unix-tidsstämpel (sekunder, flyttal). Detta fält returneras inte om uppdraget inte är slutfört.
elapsed, den tid som uppdraget tog att utföra, i sekunder (flyttal, med tre decimaler). Detta fält returneras inte om uppdraget inte är slutfört.

Batchfrågeoperationer

Detta är för att fråga detaljer om videouppdrag för flera uppdrag ID:n, och till skillnad från ovan måste action väljas som retrieve_batch. Begärningskropp inkluderar:

ids: en array av uppladdade uppdrag ID:n.
action: hur uppdraget ska hanteras.

Inställningarna ser ut som på bilden nedan:

Kodexempel

Det kan noteras att olika språkets kod redan har genererats automatiskt på högra sidan, som visas på bilden:

Några kodexempel är som följer:

Svarsexempel

Vid en lyckad begäran kommer API:t att returnera detaljerad information om alla batchvideouppdrag. Till exempel:

{
  "items": [
    {
      "_id": "67866fad550a4144a587053c",
      "id": "09d4a93e-d5c8-4778-bdf2-711773d71c59",
      "api_id": "d5af91f6-a7ec-4015-b0a5-d25051158470",
      "application_id": "2f9f4d93-9193-4c49-a1a5-eddf0ff38abb",
      "created_at": 1736863661.511,
      "started_at": 1736863661.571,
      "finished_at": 1736863730.671,
      "elapsed": 69.1,
      "credential_id": "f634e655-012e-432e-92a8-a87e4a80d636",
      "request": {
        "action": "generate",
        "prompt": "Intern värme"
      },
      "trace_id": "0edc94c6-4938-4bff-bb16-20364c254e40",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "response": {
        "success": true,
        "task_id": "09d4a93e-d5c8-4778-bdf2-711773d71c59",
        "trace_id": "0edc94c6-4938-4bff-bb16-20364c254e40",
        "data": [
          {
            "id": "24zdgea0s1rge0cmcmjbsfj2m8",
            "model": "minimax-t2v",
            "prompt": "Intern värme",
            "first_image_url": null,
            "video_url": "https://platform.cdn.acedata.cloud/czjl/6cTYBRBDVJIQANzG7GaPwPblbeIiFe4yUDcVoMkkXttqJCFUA/tmpm4ke45c5.output.mp4",
            "state": "lyckades"
          }
        ]
      }
    },
    {
      "_id": "67866dff550a4144a5867aa7",
      "id": "58cc618b-9639-4ee7-add2-d2fcf260d9a3",
      "api_id": "d5af91f6-a7ec-4015-b0a5-d25051158470",
      "application_id": "2f9f4d93-9193-4c49-a1a5-eddf0ff38abb",
      "created_at": 1736863231.588,
      "started_at": 1736863231.648,
      "finished_at": 1736863300.748,
      "elapsed": 69.1,
      "credential_id": "f634e655-012e-432e-92a8-a87e4a80d636",
      "request": {
        "action": "generate",
        "prompt": "Intern värme"
      },
      "trace_id": "0c1f9f13-0aef-4d9a-a9d2-1d27055ff190",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "response": {
        "success": true,
        "task_id": "58cc618b-9639-4ee7-add2-d2fcf260d9a3",
        "trace_id": "0c1f9f13-0aef-4d9a-a9d2-1d27055ff190",
        "data": [
          {
            "id": "2a1tbgnjdxrg80cmcmes19s33r",
            "model": "minimax-t2v",
            "prompt": "Intern värme",
            "first_image_url": null,
            "video_url": "https://platform.cdn.acedata.cloud/czjl/tjU3QYKgU96IJFgpL0eMfBFhmy0qXz9Y05P2IBhShCYaDCFUA/tmp5uligw3a.output.mp4",
            "state": "lyckades"
          }
        ]
      }
    }
  ],
  "count": 2
}

CURL

curl -X POST 'https://api.acedata.cloud/hailuo/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["09d4a93e-d5c8-4778-bdf2-711773d71c59","58cc618b-9639-4ee7-add2-d2fcf260d9a3"],
  "action": "retrieve_batch"
}'

Python

import requests

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

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

payload = {
    "ids": ["09d4a93e-d5c8-4778-bdf2-711773d71c59","58cc618b-9639-4ee7-add2-d2fcf260d9a3"],
    "action": "retrieve_batch"
}

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

Felhantering

Vid anrop av API:et, om ett fel uppstår, kommer API:et att returnera motsvarande felkod och information. Till exempel:

400 token_mismatched：Felaktig begäran, möjligtvis på grund av saknade eller ogiltiga parametrar.
400 api_not_implemented：Felaktig begäran, möjligtvis på grund av saknade eller ogiltiga parametrar.
401 invalid_token：Obehörig, ogiltig eller saknad auktoriseringstoken.
429 too_many_requests：För många begärningar, du har överskridit hastighetsgränsen.
500 api_error：Intern serverfel, något gick fel på servern.

Felrespons Exempel

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "hämtning misslyckades"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Slutsats

Genom detta dokument har du fått en förståelse för hur man använder Hailuo Tasks API för att hämta alla specifika detaljer om enskilda eller batchvideouppgifter. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera och använda API:et. Om du har några frågor, tveka inte att kontakta vårt tekniska supportteam.

Getting Started

AI Samtal

AI Bild

AI Video

AI Ljud

Web & Data

CAPTCHA

Identitet

Proxy

Advanced

Coding

Hailuo Tasks API:s integration och användning

Ansökningsprocess

Begärningsexempel

Uppdragsexempelbild

Ställ in begärningshuvuden och begärningskropp

Kodexempel

CURL

Python

Svarsexempel

Batchfrågeoperationer

Kodexempel

Svarsexempel

CURL

Python

Felhantering

Felrespons Exempel

Slutsats

​Ansökningsprocess

​Begärningsexempel

​Uppdragsexempelbild

​Ställ in begärningshuvuden och begärningskropp

​Kodexempel

​CURL

​Python

​Svarsexempel

​Batchfrågeoperationer

​Kodexempel

​Svarsexempel

​CURL

​Python

​Felhantering

​Felrespons Exempel

​Slutsats

Ansökningsprocess

Begärningsexempel

Uppdragsexempelbild

Ställ in begärningshuvuden och begärningskropp

Kodexempel

CURL

Python

Svarsexempel

Batchfrågeoperationer

Kodexempel

Svarsexempel

CURL

Python

Felhantering

Felrespons Exempel

Slutsats