gemini代理api如何使用？开发者必备配置教程与代码分享

天启代理API到底是什么？

简单来说，天启代理API就是一个让你能按需获取代理IP地址的接口。你不用自己去维护一堆IP列表，只需要调用这个API，它就会返回给你一个或多个当前可用的代理IP和端口。这就像是一个自动售货机，你需要的时候按一下按钮，它就给你一瓶水（代理IP），省去了自己跑去水源地打水的麻烦。

对于开发者而言，使用API方式管理代理IP是最高效的选择。它能够无缝集成到你的爬虫、数据采集、自动化脚本等程序中，实现IP的自动切换和获取，大大提升了工作的自动化程度和稳定性。

获取天启代理API接入信息

在使用之前，你首先需要拥有天启代理的账户并获取API的接入凭证。这个过程很简单：

1. 注册天启代理账号并登录管理后台。

2. 在后台你可以找到你的API接口地址。这个地址通常长这样：`http://tianqi.xxxx.com/api`（具体以天启代理后台提供的为准）。

3. 你还需要获取你的授权密钥，这可能是一个`token`或者是`username/password`形式的认证信息。天启代理支持终端IP授权和账号密码授权两种方式，你可以根据自己业务的便利性和安全性要求来选择。

核心配置参数详解

调用天启代理API时，通过传递不同的参数，你可以精确控制获取的IP类型，这是实现高效工作的关键。以下是几个最常用的参数：

protocol：协议类型。天启代理支持HTTP、HTTPS和SOCKS5三种协议，你需要根据你的目标网站或应用程序支持的协议来选择。例如，如果你的程序主要访问普通网页，选HTTP或HTTPS即可；如果需要更高的匿名性或者用于某些特定软件，SOCKS5是更好的选择。

num：一次获取IP的数量。如果你需要同时运行多个任务，可以一次性获取多个IP，避免频繁调用API。

format：返回数据的格式。通常选择`json`，方便程序解析。天启代理的API响应速度很快，接口请求时间小于1秒，保证了你的业务流畅性。

quality或type：IP品质或类型。这里你可以指定需要短效动态IP（适合高频切换场景）还是长效静态IP（适合需要稳定会话的场景）。天启代理提供3-30分钟的短效IP和1-24小时的长效IP，满足不同业务需求。

实战代码分享：Python调用示例

理论说再多，不如一行代码来得实在。下面我们用Python语言，展示如何调用天启代理API并实际使用获取到的IP。

我们调用API获取一个IP：

import requests

 你的天启代理API接口和参数
api_url = "http://tianqi.xxxx.com/api"   请替换为后台提供的真实地址
params = {
    'key': '你的API_KEY',   你的授权密钥
    'num': 1,              获取1个IP
    'protocol': 'http',     协议为HTTP
    'format': 'json'        返回json格式
}

response = requests.get(api_url, params=params)
ip_data = response.json()

if ip_data['code'] == 200:   假设成功返回码为200
    proxy_ip = ip_data['data'][0]['ip']
    proxy_port = ip_data['data'][0]['port']
    print(f"获取到的代理IP：{proxy_ip}:{proxy_port}")
else:
    print("获取代理IP失败：", ip_data['msg'])

拿到IP后，我们用它来访问一个目标网站：

 使用上面获取到的代理IP构造代理字典
proxies = {
    'http': f'http://{proxy_ip}:{proxy_port}',
    'https': f'http://{proxy_ip}:{proxy_port}'   注意：如果API返回是HTTP协议，这里也先用http
}

try:
     尝试访问一个测试网站，它会返回你的当前IP
    test_url = "http://httpbin.org/ip"
    resp = requests.get(test_url, proxies=proxies, timeout=10)
    print("通过代理访问成功，当前IP为：", resp.json()['origin'])
except Exception as e:
    print("访问失败：", e)

这段代码清晰地展示了从获取到使用的完整流程。天启代理的IP可用率高达99%以上，响应延迟低，所以绝大多数情况下都能成功访问。