メインコンテンツへスキップ
本文では、人像动漫化 API の対接説明を紹介します。これは、顔写真を入力することで、個性的な二次元アニメキャラクターを生成できるもので、個性的なアイコン、趣味活動、エフェクト系アプリケーションなどのシーンで使用でき、ソーシャルエンターテイメントの体験を向上させます。

​
申請プロセス

APIを使用するには、まず 人像动漫化 API の該当ページでサービスを申請する必要があります。ページに入ったら、「Acquire」ボタンをクリックします。以下の図のように： まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。ログインまたは登録後、現在のページに自動的に戻ります。 初回申請時には無料のクレジットが付与され、このAPIを無料で使用できます。

​
基本使用

まず、基本的な使用方法を理解します。画像リンクを入力することで、処理後の結果画像を得ることができます。まず、シンプルに image_url フィールドを渡す必要があります。顔画像は以下の図のように：

次に、画面上に対応する内容を記入できます。以下の図のように：

ここでは、Request Headersを設定しました。これには以下が含まれます：
  • accept：受け取りたいレスポンス結果の形式。ここでは application/json、つまりJSON形式を記入します。
  • authorization：APIを呼び出すためのキー。申請後、直接ドロップダウンから選択できます。
さらに、Request Bodyを設定しました。これには以下が含まれます：
  • image_url：処理する顔画像のリンク。
選択後、右側にも対応するコードが生成されていることがわかります。以下の図のように：

「Try」ボタンをクリックするとテストが行えます。上の図のように、以下の結果が得られました： 
{
  "image_url": "https://faceeffect-1254418846.cos.ap-guangzhou.myqcloud.com/ft/FaceCartoonPic/1256437459/8567833b-7831-406c-9ff5-890e5f7e020e"
}
ここで返された結果には image_url フィールドがあり、変化後のカートゥーン顔画像が含まれています。変化後の顔情報は以下のようになります：

画像中の顔は、個性的な二次元アニメキャラクターに生成されています。 また、対応する対接コードを生成したい場合は、生成されたものを直接コピーできます。例えば、CURLのコードは以下の通りです： 
curl -X POST 'https://api.acedata.cloud/face/cartoon' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg"
}'
Pythonの対接コードは以下の通りです： 
import requests

url = "https://api.acedata.cloud/face/cartoon"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg"
}

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"
}

​
結論

この文書を通じて、あなたは人像动漫化 API を使用して入力された画像から個性的な二次元アニメキャラクターを生成する方法を理解しました。この文書が、APIの対接と使用をより良くする手助けとなることを願っています。何か問題があれば、いつでも私たちの技術サポートチームにお問い合わせください。