> ## Documentation Index > Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt > Use this file to discover all available pages before exploring further. # Luma Tasks API:s integration och användning > Luma Video Generation 集成指南 - XHuoAPI Luma Tasks API:s huvudfunktion är att genom att ange det uppdrag-ID som genererats av Luma Videos Generation API för att kontrollera statusen för det uppdraget. Detta dokument kommer att detaljerat beskriva Luma Tasks API:s integrationsanvisningar, för att hjälpa dig att enkelt integrera och fullt utnyttja denna APIs kraftfulla funktioner. Genom Luma Tasks API kan du enkelt kontrollera statusen för uppdrag som utförs av Luma Videos Generation API. ## Ansökningsprocess För att använda Luma Tasks API måste du först gå till ansökningssidan [Luma Videos Generation API](https://api.xhuoapi.ai/documents/5bd3597d-1ff8-44ad-a580-b66b48393e7f) för att ansöka om den aktuella tjänsten, och sedan kopiera Luma Videos Generation API:s uppdrag-ID, som visas i bilden nedan: ![](https://cdn.xhuoapi.ai/ynk4ow.png) Slutligen går du till Tasks API-sidan [Luma Tasks API](https://api.xhuoapi.ai/documents/7d32369c-4ead-4364-a4c5-652bc768b3ff) för att ansöka om den aktuella tjänsten. När du kommer till sidan, klicka på knappen "Acquire", som visas i bilden nedan: ![Ansökningssidan](https://cdn.xhuoapi.ai/rci31i.png) Om du inte har loggat in eller registrerat dig kommer du automatiskt att omdirigeras till [inloggningssidan](https://api.xhuoapi.ai) för att registrera dig och logga in. Efter att du har loggat in eller registrerat dig kommer du automatiskt att återvända till den aktuella sidan. Vid första ansökan kommer det att finnas en gratis kvot som ges, så att du kan använda denna API gratis. ## Begärningsexempel Luma Tasks API kan användas för att kontrollera resultaten från Luma Videos Generation API. För information om hur man använder Luma Videos Generation API, se dokumentet [Luma Videos Generation API](https://api.xhuoapi.ai/documents/16bb0108-1f09-45b3-97ac-16a668750a8c). Vi tar ett exempel med ett uppdrag-ID som returnerats av Luma Videos Generation API för att demonstrera hur man använder denna API. Anta att vi har ett uppdrag-ID: 50fc6182-fa86-4c7d-ac12-2fa27ec2f151, 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`: specificera 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 visas i bilden nedan:

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

Några kodexempel visas nedan: #### CURL ```bash theme={null} curl -X POST 'https://api.xhuoapi.ai/v1/luma/tasks' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "id": "50fc6182-fa86-4c7d-ac12-2fa27ec2f151", "action": "retrieve" }' ``` #### Python ```python theme={null} import requests url = "https://api.xhuoapi.ai/v1/luma/tasks" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "id": "50fc6182-fa86-4c7d-ac12-2fa27ec2f151", "action": "retrieve" } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` ### Svarsexempel När begäran lyckas kommer API:t att returnera detaljerad information om videouppdraget här. Till exempel: ```json theme={null} { "_id": "66d297a3550a4144a5a5db42", "id": "50fc6182-fa86-4c7d-ac12-2fa27ec2f151", "api_id": "94fc9028-5a9f-4875-aae4-38463bd30ac5", "application_id": "06484a45-9d04-498a-98a7-67086dee8166", "created_at": 1725077411.961, "credential_id": "e6a879e5-a7c0-4f7b-9d6f-f9a837421a50", "request": { "action": "generate", "prompt": "Astronauter transporterar från rymden till vulkan" }, "trace_id": "0b7c1c1a-045c-4145-a434-609cba88f0a9", "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf", "response": { "success": true, "task_id": "50fc6182-fa86-4c7d-ac12-2fa27ec2f151", "video_id": "4b088fc8-2bbc-4706-80a6-a0fb118adc1a", "prompt": "Astronauter transporterar från rymden till vulkan", "video_url": "https://platform.cdn.xhuoapi.ai/luma/50fc6182-fa86-4c7d-ac12-2fa27ec2f151.mp4", "video_height": 752, "video_width": 1360, "state": "completed", "thumbnail_url": "https://platform.cdn.xhuoapi.ai/luma/50fc6182-fa86-4c7d-ac12-2fa27ec2f151.jpg", "thumbnail_width": 1360, "thumbnail_height": 752 }, "finished_at": 1725077566.241 } ``` Det returnerade resultatet har flera fält, där `request`-fältet är begärningskroppen som initierade uppdraget, medan `response`-fältet är svaret som returnerades efter att uppdraget slutfördes, vars resultat överensstämmer med begäran och svaret från Luma Videos Generation API. Fälten beskrivs nedan. * `id`, ID:t för att generera detta videouppdrag, används för att unikt identifiera detta videogenereringsuppdrag. * `video_id`, den unika identifieraren för videon i det här videouppdraget, som behövs för att utföra utvidgningsoperationer på videon nästa gång. * `request`, begärningsinformationen i videouppdraget. * `response`, returinformationen i videouppdraget. ## 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 visas i bilden nedan:

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

Några kodexempel visas nedan: ### Svarsexempel När begäran lyckas kommer API:t att returnera detaljerad information om alla batchvideouppdrag. Till exempel: ```json theme={null} { "items": [ { "_id": "66d297a3550a4144a5a5db42", "id": "50fc6182-fa86-4c7d-ac12-2fa27ec2f151", "api_id": "94fc9028-5a9f-4875-aae4-38463bd30ac5", "application_id": "06484a45-9d04-498a-98a7-67086dee8166", "created_at": 1725077411.961, "credential_id": "e6a879e5-a7c0-4f7b-9d6f-f9a837421a50", "request": { "action": "generate", "prompt": "Astronauter skjuts från rymden till vulkan" }, "trace_id": "0b7c1c1a-045c-4145-a434-609cba88f0a9", "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf", "response": { "success": true, "task_id": "50fc6182-fa86-4c7d-ac12-2fa27ec2f151", "video_id": "4b088fc8-2bbc-4706-80a6-a0fb118adc1a", "prompt": "Astronauter skjuts från rymden till vulkan", "video_url": "https://platform.cdn.xhuoapi.ai/luma/50fc6182-fa86-4c7d-ac12-2fa27ec2f151.mp4", "video_height": 752, "video_width": 1360, "state": "completed", "thumbnail_url": "https://platform.cdn.xhuoapi.ai/luma/50fc6182-fa86-4c7d-ac12-2fa27ec2f151.jpg", "thumbnail_width": 1360, "thumbnail_height": 752 }, "finished_at": 1725077566.241 }, { "_id": "66d29ed3550a4144a5a6c089", "id": "76a05f61-68ad-4c1a-838f-a00cd08cf65b", "api_id": "94fc9028-5a9f-4875-aae4-38463bd30ac5", "application_id": "06484a45-9d04-498a-98a7-67086dee8166", "created_at": 1725079250.921, "credential_id": "e6a879e5-a7c0-4f7b-9d6f-f9a837421a50", "request": { "action": "generate", "prompt": "la la la" }, "trace_id": "338f1616-741d-40b6-8d62-c025434024c6", "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf", "response": { "success": true, "task_id": "76a05f61-68ad-4c1a-838f-a00cd08cf65b", "video_id": "5a638d6a-7481-4c5e-8843-36c9d1b5bcd5", "prompt": "la la la", "video_url": "https://platform.cdn.xhuoapi.ai/luma/76a05f61-68ad-4c1a-838f-a00cd08cf65b.mp4", "video_height": 752, "video_width": 1360, "state": "completed", "thumbnail_url": "https://platform.cdn.xhuoapi.ai/luma/76a05f61-68ad-4c1a-838f-a00cd08cf65b.jpg", "thumbnail_width": 1360, "thumbnail_height": 752 }, "finished_at": 1725079406.71 } ], "count": 2 } ``` #### CURL ```bash theme={null} curl -X POST 'https://api.xhuoapi.ai/v1/luma/tasks' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "ids": ["50fc6182-fa86-4c7d-ac12-2fa27ec2f151","76a05f61-68ad-4c1a-838f-a00cd08cf65b"], "action": "retrieve_batch" }' ``` #### Python ```python theme={null} import requests url = "https://api.xhuoapi.ai/v1/luma/tasks" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "ids": ["50fc6182-fa86-4c7d-ac12-2fa27ec2f151","76a05f61-68ad-4c1a-838f-a00cd08cf65b"], "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 ```json theme={null} { "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 Luma Tasks API för att hämta detaljerad information 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.