Everypixel API 开发使用指南

概述

Everypixel API 提供图像识别服务，用户可以通过该 API 上传图像或视频并获取相关的预测信息。API 支持多种功能，包括关键字生成、图像质量评分、人脸检测、视频换脸等。

获取 API 密钥

1. 注册 Everypixel 账号。
2. 登录后，获取 API 访问凭证（client_id 和 client_secret）。
3. 妥善保管这些凭证，确保安全。

版本控制

API 的版本控制是 URI 的一部分。使用 v1 版本的 API，请确保请求 URI 以 /v1 开头。

身份验证

API 支持基本访问身份验证和 OAuth 2.0 身份验证。以下示例使用基本身份验证。

API 方法

1. 关键字生成

• 请求方法: GET / POST
• URI: /v1/keywords
• 参数:

• url: 图像的 URL 或通过 data 参数上传图像。
• num_keywords: 返回的关键字数量。
• colors: 是否返回颜色关键字（布尔值）。
• num_colors: 返回的颜色数量。
• lang: 语言（默认值为 en）。

示例:

import requests

client_id = '<your-client-id>'
client_secret = '<your-client-secret>'
params = {
    'url': 'http://image.everypixel.com/2014.12/67439828186edc79b9be81a4dedea8b03c09a12825b_b.jpg',
    'num_keywords': 10,
    'colors': True,
    'num_colors': 5,
    'lang': 'en'
}

response = requests.get('https://api.everypixel.com/v1/keywords', params=params, auth=(client_id, client_secret))
print(response.json())

2. 图像质量评分

• 请求方法: GET / POST
• URI: /v1/quality
• 参数:

• url: 图像的 URL。

示例:

response = requests.get('https://api.everypixel.com/v1/quality', params={'url': 'http://image.everypixel.com/...'}, auth=(client_id, client_secret))
print(response.json())

3. 人脸检测

• 请求方法: GET / POST
• URI: /v1/faces
• 参数:

• url: 图像的 URL。

示例:

response = requests.get('https://api.everypixel.com/v1/faces', params={'url': 'https://labs.everypixel.com/static/i/estest_sample3.jpg'}, auth=(client_id, client_secret))
print(response.json())

4. 视频关键字生成

• 请求方法: GET / POST
• URI: /v1/video_keywords
• 参数:

• url: 视频的 URL。
• num_keywords: 返回的关键字数量。

示例:

response = requests.get('https://api.everypixel.com/v1/video_keywords', params={'url': 'https://media.gettyimages.com/...', 'num_keywords': 10}, auth=(client_id, client_secret))
print(response.json())

5. 文本转语音

• 请求方法: POST / GET
• URI: /v1/tts/create
• 参数:

• text: 要转换的文本。

示例:

response = requests.post('https://api.everypixel.com/v1/tts/create', data={'text': 'Hello, world!'}, auth=(client_id, client_secret))
task_id = response.json().get("task_id")

6. 回调

当使用 TTS、Lipsync、Imageswap 和 Videoswap API 时，您可以指定回调 URL，以便接收任务状态和文件 URL 的 POST 请求。

错误处理

• 401: 无权访问指定端点（可能是访问令牌过期）。
• 429: 超出可用请求数。

结论

Everypixel API 提供了丰富的图像和视频处理功能，开发者可以根据需求集成相应的 API 方法。确保遵循 API 文档中的示例和参数设置，以获取最佳效果。