> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/pt-br/proxies/high-bandwidth-proxies.md). # High-Bandwidth Proxies ## Primeiros passos Para começar a usar nossos [**High Bandwidth Proxies**](https://oxylabs.io/products/high-bandwidth-proxies) para extração de dados de vídeo e áudio, entre em contato com nossa equipe de vendas para receber seu endpoint dedicado. Cada cliente recebe um Proxy Endpoint exclusivo configurado para suas necessidades específicas. Para integrar diretamente esta solução com `yt_dlp` biblioteca, confira o [exemplo](#example-integration-youtube-downloader) abaixo ou confira nossos [Agent Skills](#agent-skills) para fluxos de trabalho de IA. ## Configuração do endpoint Após receber seu Proxy Endpoint da equipe de gerenciamento de conta, você receberá: * Um Proxy Endpoint dedicado * Seu nome de usuário e senha * Número da porta (padrão: `60000`) ## Exemplo de integração: YouTube Downloader Aqui está um exemplo usando `yt-dlp` com nossos High Bandwidth Proxies para extração de dados de vídeo ou áudio: ### Uso básico {% tabs %} {% tab title="Bash" %} ```bash yt-dlp --proxy username-$(openssl rand -hex 16):password@endpoint:60000 \\ "https://www.youtube.com/watch?v=WNCl-69POro" ``` {% endtab %} {% tab title="Python" %} ```python import os import yt_dlp username = 'YOUR_USERNAME' password = 'YOUR_PASSWORD' proxy = f'http://{username}-{os.urandom(16).hex()}:{password}@your-endpoint:60000' ydl_opts = { 'proxy': proxy, } with yt_dlp.YoutubeDL(ydl_opts) as ydl: ydl.download(['https://www.youtube.com/watch?v=WNCl-69POro']) ``` {% endtab %} {% endtabs %} {% hint style="info" %} Para desempenho ideal, certifique-se de que cada vídeo seja baixado usando um endereço IP separado. Consulte a seção abaixo para orientação. {% endhint %} ### Vários URLs com IPs diferentes Ao usar High Bandwidth Proxies, cada vídeo é baixado com um endereço IP separado para garantir o desempenho ideal. Isso é feito gerando um ID de sessão exclusivo para cada solicitação, o que atribui efetivamente um novo endereço IP para cada download. {% tabs %} {% tab title="Bash" %} ```bash # Primeiro vídeo com um IP yt-dlp --proxy username-$(openssl rand -hex 16):password@endpoint:60000 \\ "https://www.youtube.com/watch?v=6stlCkUDG_s" # Segundo vídeo com IP diferente yt-dlp --proxy username-$(openssl rand -hex 16):password@endpoint:60000 \\ "https://www.youtube.com/watch?v=gsnqXt7d1mU" ``` {% endtab %} {% tab title="Python" %} ```python import os import yt_dlp def download_with_new_ip(url, username, password): session_id = os.urandom(16).hex() proxy = f'http://{username}-{session_id}:{password}@your-endpoint:60000' ydl_opts = { 'proxy': proxy } with yt_dlp.YoutubeDL(ydl_opts) as ydl: try: print(f"Downloading {url} with new IP ({username}-{session_id})...") ydl.download([url]) print(f"Successfully downloaded {url}") except Exception as e: print(f"Error downloading {url}: {str(e)}") def main(): username = 'YOUR_USERNAME' password = 'YOUR_PASSWORD' videos = [ 'https://www.youtube.com/watch?v=6stlCkUDG_s', 'https://www.youtube.com/watch?v=gsnqXt7d1mU' ] for video in videos: download_with_new_ip(video, username, password) if __name__ == "__main__": main() ``` {% endtab %} {% endtabs %} {% hint style="info" %} A função inclui tratamento básico de erros para garantir que o processo continue mesmo se um download falhar. {% endhint %} ## Agent Skills Para usar os High Bandwidth Proxies da Oxylabs em fluxos de trabalho de IA, você também pode usar Agent Skills (`skills.md`) para ensinar LLMs e assistentes de codificação de IA a configurar e interagir com produtos da Oxylabs. O `video-data` agent skill ajuda seu modelo a configurar streaming e downloads brutos de mídia de vídeo/áudio por meio de `yt-dlp` sem alucinações de sintaxe ou de parâmetros. {% hint style="info" %} **Observação:** `video-data` a skill também inclui coleta estruturada de dados (resultados de busca, metadados etc.) por meio da Web Scraper API. [Saiba mais](/products/pt-br/web-scraper-api/solutions-for-ai-workflows/habilidades-do-agente.md#video-data). {% endhint %} ### Instalação #### Claude Code (marketplace de plugins) Dentro do Claude Code, execute os seguintes comandos: ``` /plugin marketplace add oxylabs/agent-skills /plugin install oxylabs@oxylabs-agent-skills ``` Isso instala todas as 5 skills como um único plugin: * [`skills/proxies`](https://github.com/oxylabs/agent-skills/blob/main/skills/proxies/SKILL.md) * [`skills/web-unblocker`](https://github.com/oxylabs/agent-skills/blob/main/skills/web-unblocker/SKILL.md) * [`skills/web-scraper-api`](https://github.com/oxylabs/agent-skills/blob/main/skills/web-scraper-api/SKILL.md) * [`skills/headless-browser`](https://github.com/oxylabs/agent-skills/blob/main/skills/headless-browser/SKILL.md) * [`skills/video-data`](https://github.com/oxylabs/agent-skills/blob/main/skills/video-data/SKILL.md) Para atualizar as skills, execute este comando: ``` /plugin marketplace update oxylabs-agent-skills ``` #### Outros agentes (genérico) Para outros agentes e ambientes personalizados, carregue o repositório no workspace do seu projeto via a CLI padrão de skills: ``` npx skills add https://github.com/oxylabs/agent-skills.git ``` ### Configuração Todas as Oxylabs Agent Skills se autenticam por meio de variáveis de ambiente definidas em um `.env` arquivo. Para usar `video-data` skills, adicione estas chaves ao seu `.env` arquivo: | Variável | Descrição | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `OXY_HB_ENDPOINT` | Seu gateway de Proxy Endpoint de alta largura de banda | | `OXY_WSA_USERNAME` | (Opcional) Seu usuário da Web Scraper API `username`. [Saiba mais](/products/pt-br/web-scraper-api/solutions-for-ai-workflows/habilidades-do-agente.md#video-data). | | `OXY_WSA_PASSWORD` | (Opcional) Seu usuário da Web Scraper API `password`. [Saiba mais](/products/pt-br/web-scraper-api/solutions-for-ai-workflows/habilidades-do-agente.md#video-data). | ### Como usar Depois que a skill estiver ativa, você pode pedir ao seu assistente de IA para gerar scripts de entrega de mídia otimizados para rede. * **Exemplo 1:** "Crie um script de shell que passe minhas `OXY_HB_ENDPOINT` configurações de gateway diretamente para `yt-dlp` para baixar vídeos brutos de uma URL." * **Exemplo 2:** "Escreva um script Python usando `ffmpeg` e rotação de proxy para transmitir grandes ativos binários de vídeo pelo nó de entrada High-Bandwidth." --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://developers.oxylabs.io/products/pt-br/proxies/high-bandwidth-proxies.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.