> ## 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. # Интеграция и использование Hailuo Tasks API > Hailuo Video Generation 集成指南 - XHuoAPI Основная функция Hailuo Tasks API заключается в том, чтобы запрашивать статус выполнения задачи, используя ID задачи, сгенерированный Hailuo Videos Generation API. В этом документе подробно описывается интеграция Hailuo Tasks API, чтобы помочь вам легко интегрировать и в полной мере использовать мощные функции этого API. С помощью Hailuo Tasks API вы можете легко реализовать запрос статуса выполнения задач Hailuo Videos Generation API. ## Процесс подачи заявки Чтобы использовать Hailuo Tasks API, сначала необходимо перейти на страницу заявки [Hailuo Videos Generation API](https://api.xhuoapi.ai/documents/ee06377b-9185-438f-ac84-3376bcb1275e) и подать заявку на соответствующую услугу, затем скопировать ID задачи Hailuo Videos Generation API, как показано на изображении:

Затем перейдите на страницу Tasks API [Hailuo Tasks API](https://api.xhuoapi.ai/documents/4b1ccdbc-b8ed-4171-9a14-48e10970ba04) и подайте заявку на соответствующую услугу, после входа на страницу нажмите кнопку «Acquire», как показано на изображении: ![Страница заявки](https://cdn.xhuoapi.ai/rci31i.png) Если вы еще не вошли в систему или не зарегистрированы, вы будете автоматически перенаправлены на [страницу входа](https://api.xhuoapi.ai), где вас пригласят зарегистрироваться и войти в систему. После регистрации и входа вы будете автоматически возвращены на текущую страницу. При первой подаче заявки предоставляется бесплатный лимит, который позволяет бесплатно использовать этот API. ## Пример запроса Hailuo Tasks API можно использовать для запроса результатов Hailuo Videos Generation API. Для получения информации о том, как использовать Hailuo Videos Generation API, пожалуйста, обратитесь к документу [Hailuo Videos Generation API](https://api.xhuoapi.ai/documents/d2fc9087-2996-4573-bfe5-8b1c828fdfc7). Мы возьмем один из ID задач, возвращенных службой Hailuo Videos Generation API, в качестве примера, чтобы продемонстрировать, как использовать этот API. Предположим, у нас есть ID задачи: 58cc618b-9639-4ee7-add2-d2fcf260d9a3, далее мы покажем, как передать этот ID задачи. ### Пример задачи

### Установка заголовков запроса и тела запроса **Request Headers** включает: * `accept`: указывает на прием ответа в формате JSON, здесь указывается `application/json`. * `authorization`: ключ для вызова API, который можно выбрать из выпадающего списка после подачи заявки. **Request Body** включает: * `id`: загруженный ID задачи. * `action`: способ выполнения операции над задачей. Настройка, как показано на изображении:

### Пример кода Можно заметить, что на правой стороне страницы автоматически сгенерирован код на различных языках, как показано на изображении:

Некоторые примеры кода: #### CURL ```bash theme={null} curl -X POST 'https://api.xhuoapi.ai/v1/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 ```python theme={null} import requests url = "https://api.xhuoapi.ai/v1/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) ``` ### Пример ответа После успешного запроса API вернет детали этой видео задачи. Например: ```json theme={null} { "_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, "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://file.aigpai.com/czjl/tjU3QYKgU96IJFgpL0eMfBFhmy0qXz9Y05P2IBhShCYaDCFUA/tmp5uligw3a.output.mp4", "state": "succeeded" } ] } } ``` Возвращаемый результат содержит несколько полей, поле request — это тело запроса, отправленного для создания задачи, в то время как поле response — это тело ответа, возвращенное после завершения задачи. Описание полей: * `id`: ID, сгенерированный для этой видео задачи, используется для уникальной идентификации данной задачи по созданию видео. * `request`: информация о запросе в видео задаче. * `response`: информация о возвращаемом ответе в видео задаче. ## Пакетный запрос Это запрос для получения деталей видео задач по нескольким ID задач, в отличие от предыдущего, здесь необходимо выбрать action как retrieve\_batch. **Request Body** включает: * `ids`: массив загруженных ID задач. * `action`: способ выполнения операции над задачей. Настройка, как показано на изображении:

### Пример кода Можно заметить, что на правой стороне страницы автоматически сгенерирован код на различных языках, как показано на изображении:

Некоторые примеры кода: ### Пример ответа После успешного запроса API вернет конкретные детали всех пакетных видео задач. Например: ```json theme={null} { "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, "credential_id": "f634e655-012e-432e-92a8-a87e4a80d636", "request": { "action": "generate", "prompt": "Внутреннее тепло" }, "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": "Внутреннее тепло", "first_image_url": null, "video_url": "https://file.aigpai.com/czjl/6cTYBRBDVJIQANzG7GaPwPblbeIiFe4yUDcVoMkkXttqJCFUA/tmpm4ke45c5.output.mp4", "state": "succeeded" } ] } }, { "_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, "credential_id": "f634e655-012e-432e-92a8-a87e4a80d636", "request": { "action": "generate", "prompt": "Внутреннее тепло" }, "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": "Внутреннее тепло", "first_image_url": null, "video_url": "https://file.aigpai.com/czjl/tjU3QYKgU96IJFgpL0eMfBFhmy0qXz9Y05P2IBhShCYaDCFUA/tmp5uligw3a.output.mp4", "state": "succeeded" } ] } } ], "count": 2 } ``` #### CURL ```bash theme={null} curl -X POST 'https://api.xhuoapi.ai/v1/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 ```python theme={null} import requests url = "https://api.xhuoapi.ai/v1/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) ``` ## Ошибка обработки В случае возникновения ошибки при вызове API, API вернет соответствующий код ошибки и информацию. Например: * `400 token_mismatched`：Неверный запрос, возможно, из-за отсутствия или недопустимых параметров. * `400 api_not_implemented`：Неверный запрос, возможно, из-за отсутствия или недопустимых параметров. * `401 invalid_token`：Неавторизован, недопустимый или отсутствующий токен авторизации. * `429 too_many_requests`：Слишком много запросов, вы превысили лимит частоты. * `500 api_error`：Внутренняя ошибка сервера, что-то пошло не так на сервере. ### Пример ответа об ошибке ```json theme={null} { "success": false, "error": { "code": "api_error", "message": "не удалось получить" }, "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89" } ``` ## Заключение С помощью этого документа вы узнали, как использовать Hailuo Tasks API для запроса всех конкретных деталей о единичных или пакетных видео задачах. Надеемся, что этот документ поможет вам лучше интегрировать и использовать этот API. Если у вас есть какие-либо вопросы, пожалуйста, не стесняйтесь обращаться в нашу техническую поддержку.