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 接続説明を紹介します。これは、画像と年齢を入力することで、画像中の人顔の年齢を変えることができます。大まかな使い方は、ユーザーが人顔画像をアップロードし、人顔編集と生成アルゴリズムに基づいて、老化または若返りした人顔の画像を出力し、異なる年齢の人顔の変化を実現することです。
申請プロセス
APIを使用するには、まず 人顔年齢変化 API の該当ページでサービスを申請する必要があります。ページに入ったら、「Acquire」ボタンをクリックします。以下の図のように：
まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。ログインまたは登録後、現在のページに自動的に戻ります。
初回申請時には無料のクレジットが付与され、この API を無料で使用できます。
基本使用
まず、基本的な使用方法を理解します。画像リンクと年齢情報を入力することで、処理後の結果画像を得ることができます。まず、image_url フィールドを簡単に渡す必要があります。人顔画像は以下の図のように：
次に、人顔年齢情報パラメータ age_infos をアップロードする必要があります。これは配列であり、複数の情報を渡すことができます。次に、画面上に対応する内容を記入します。以下の図のように：
ここで、Request Headers を設定しました。これには以下が含まれます：
accept：どのような形式の応答結果を受け取りたいか。ここでは application/json、すなわち JSON 形式を記入します。authorization：APIを呼び出すためのキー。申請後、直接ドロップダウンから選択できます。
さらに、Request Body を設定しました。これには以下が含まれます：
image_url：処理する人顔画像のリンク。age_infos：人顔の年齢と地域情報に関するもので、年齢は必須パラメータです。
選択後、右側にも対応するコードが生成されていることがわかります。以下の図のように：
「Try」ボタンをクリックするとテストができます。上の図のように、以下の結果を得ました：
{
"image_url": "https://faceeffect-1254418846.cos.ap-guangzhou.myqcloud.com/ft/ChangeAgePic/1256437459/bfce1ab8-5fd7-464d-8878-b38433f84d0e"
}
image_url フィールドがあります。変化後の人顔情報は以下の図のように：
画像中の人顔は、入力された年齢に基づいて変化しています。
また、対応する接続コードを生成したい場合は、生成されたものを直接コピーできます。例えば、CURL のコードは以下の通りです：
curl -X POST 'https://api.xhuoapi.ai/v1/face/change-age' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
"age_infos": [{"age":60}],
"image_url": "https://cdn.xhuoapi.ai/f5687u.png"
}'
import requests
url = "https://api.xhuoapi.ai/v1/face/change-age"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}",
"content-type": "application/json"
}
payload = {
"age_infos": [{"age":60}],
"image_url": "https://cdn.xhuoapi.ai/f5687u.png"
}
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：内部サーバーエラー、サーバーで何かがうまくいきませんでした。
エラー応答の例
{
"success": false,
"error": {
"code": "api_error",
"message": "fetch failed"
},
"trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}
