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

Затем перейдите на страницу API Tasks [Veo Tasks API](https://api.xhuoapi.ai/documents/52778f8b-93ce-4db3-a62c-bcf0a92e5f3c) и подайте заявку на соответствующую услугу, после перехода на страницу нажмите кнопку «Acquire», как показано на рисунке: ![Страница заявки](https://cdn.xhuoapi.ai/rci31i.png) Если вы еще не вошли в систему или не зарегистрированы, вы будете автоматически перенаправлены на [страницу входа](https://api.xhuoapi.ai), где вас пригласят зарегистрироваться и войти в систему. После регистрации и входа вы будете автоматически возвращены на текущую страницу. При первой подаче заявки предоставляется бесплатный лимит, который позволяет бесплатно использовать этот API. ## Пример запроса API Veo Tasks можно использовать для запроса результатов API Veo Videos Generation. Для получения информации о том, как использовать API Veo Videos Generation, пожалуйста, обратитесь к документу [Veo Videos Generation API](https://api.xhuoapi.ai/documents/63e01dc3-eb21-499e-8049-3025c460058f). Мы возьмем в качестве примера один ID задачи, возвращенный сервисом API Veo Videos Generation, чтобы продемонстрировать, как использовать этот API. Предположим, у нас есть ID задачи: 1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed, далее мы покажем, как передать этот 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/veo/tasks' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed", "action": "retrieve" }' ``` #### Python ```python theme={null} import requests url = "https://api.xhuoapi.ai/v1/veo/tasks" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed", "action": "retrieve" } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` ### Пример ответа После успешного запроса API вернет информацию о деталях видео задачи. Например: ```json theme={null} { "_id": "68834c16550a4144a5112589", "id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed", "api_id": "52a0fa83-3c78-4793-b45a-c1a5c869ae46", "application_id": "b7341df0-3a87-40ef-8f3c-a7dda97816a2", "created_at": 1753435158.509, "credential_id": "1f64eaaa-eff0-4f18-bfc2-8c5b1e7949ae", "request": { "callback_url": "https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc", "action": "text2video", "model": "veo2", "prompt": "Белая керамическая кружка с кофе на глянцевом мраморном столешнице при утреннем свете из окна. Камера медленно вращается на 360 градусов вокруг кружки, на мгновение останавливаясь на ручке." }, "trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56", "type": "videos", "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf", "response": { "success": true, "task_id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed", "trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56", "data": [ { "id": "2f43ceed37944b4d836e1a1899dad0a1", "video_url": "https://platform.cdn.xhuoapi.ai/veo/1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed.mp4", "created_at": "2025-07-25 17:19:20", "complete_at": "2025-07-25 17:21:45", "state": "succeeded" } ] } } ``` Возвращаемый результат содержит несколько полей, поле request — это тело запроса, отправленного при создании задачи, а поле response — это тело ответа, возвращенное после завершения задачи. Описание полей: * `id`: ID, сгенерированный для этой видео задачи, используется для уникальной идентификации этой задачи по созданию видео. * `request`: информация о запросе в видео задаче. * `response`: информация о возвращаемом ответе в видео задаче. ## Пакетный запрос Это запрос для получения деталей видео задач по нескольким ID задач, в отличие от предыдущего, здесь необходимо выбрать action как retrieve\_batch. **Request Body** включает: * `ids`: массив загруженных ID задач. * `action`: способ выполнения операции над задачей. Настройка, как показано на рисунке:

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

Некоторые примеры кода: ### Пример ответа После успешного запроса API вернет конкретную информацию о всех пакетных видео задачах. Например: ```json theme={null} { "items": [ { "_id": "68834c16550a4144a5112589", "id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed", "api_id": "52a0fa83-3c78-4793-b45a-c1a5c869ae46", "application_id": "b7341df0-3a87-40ef-8f3c-a7dda97816a2", "created_at": 1753435158.509, "credential_id": "1f64eaaa-eff0-4f18-bfc2-8c5b1e7949ae", "request": { "callback_url": "https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc", "action": "text2video", "model": "veo2", "prompt": "Белая керамическая кружка с кофе на блестящем мраморном столешнице при утреннем свете из окна. Камера медленно вращается на 360 градусов вокруг кружки, на мгновение останавливаясь на ручке." }, "trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56", "type": "videos", "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf", "response": { "success": true, "task_id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed", "trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56", "data": [ { "id": "2f43ceed37944b4d836e1a1899dad0a1", "video_url": "https://platform.cdn.xhuoapi.ai/veo/1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed.mp4", "created_at": "2025-07-25 17:19:20", "complete_at": "2025-07-25 17:21:45", "state": "succeeded" } ] } }, { "_id": "68834c16550a4144a5112589", "id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed", "api_id": "52a0fa83-3c78-4793-b45a-c1a5c869ae46", "application_id": "b7341df0-3a87-40ef-8f3c-a7dda97816a2", "created_at": 1753435158.509, "credential_id": "1f64eaaa-eff0-4f18-bfc2-8c5b1e7949ae", "request": { "callback_url": "https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc", "action": "text2video", "model": "veo2", "prompt": "Белая керамическая кружка с кофе на блестящем мраморном столешнице при утреннем свете из окна. Камера медленно вращается на 360 градусов вокруг кружки, на мгновение останавливаясь на ручке." }, "trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56", "type": "videos", "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf", "response": { "success": true, "task_id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed", "trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56", "data": [ { "id": "2f43ceed37944b4d836e1a1899dad0a1", "video_url": "https://platform.cdn.xhuoapi.ai/veo/1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed.mp4", "created_at": "2025-07-25 17:19:20", "complete_at": "2025-07-25 17:21:45", "state": "succeeded" } ] } } ], "count": 2 } ``` Возвращаемый результат содержит несколько полей, среди которых items включает в себя конкретные детали пакетных видео задач, каждая конкретная информация о видео задаче аналогична полям выше. * `items`, все конкретные детали пакетных видео задач. Это массив, каждый элемент массива имеет такой же формат, как и результат запроса одной задачи. * `count`, количество видео задач в этом пакетном запросе. #### CURL ```bash theme={null} curl -X POST 'https://api.xhuoapi.ai/v1/veo/tasks' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "ids": ["1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed","1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed"], "action": "retrieve_batch" }' ``` ## Обработка ошибок При вызове 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": "fetch failed" }, "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89" } ``` ## Заключение С помощью этого документа вы узнали, как использовать Veo Tasks API для запроса всех конкретных деталей информации о одиночных или пакетных видео задачах. Надеемся, что этот документ поможет вам лучше интегрировать и использовать этот API. Если у вас есть какие-либо вопросы, пожалуйста, не стесняйтесь обращаться в нашу техническую поддержку.