Generate

Generate the corresponding certificate photo according to the template name and the entered person picture.

POST /headshots/generate

Generate

cURL

curl --request POST \
  --url https://api.acedata.cloud/headshots/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "mode": "fast",
  "image_urls": [
    "<string>"
  ]
}
'

200

{
  "data": [
    {
      "id": "202410231117",
      "template": "男形象照",
      "image_url": "https://static.aipedias.com/aicamera/...."
    },
    {
      "id": "2024102311170",
      "template": "男形象照",
      "image_url": "https://static.aipedias.com/aicamera/...."
    }
  ],
  "success": true,
  "task_id": "5636d6ba-957f-475e-a98a-718a07ee89a6"
}

授權

Authorization · string · header · 必填

API token from https://platform.acedata.cloud

標頭

accept · enum<string>

Specifies the format of the response from the server.

可用選項: application/json

主體

application/json

mode · enum<string> · 預設值: fast · 必填

The channel speed for generating ID photos is fast by default.

可用選項: fast, relax

template · enum<string> · 必填

The style of the Headshot. Use 'generate' for the first time and templates values for subsequent styles, and you can specify specific template to perform on the generated Headshots.

可用選項: male_portrait, male_portrait2, kindergarten, logo_tshirt, wedding, business_photo, bob_suit, female_portrait

image_urls · string[] · 必填

A link to a portrait image or base64 encoding.

callback_url · string

Webhook callback URL for asynchronous notifications.

回應

200

application/json

Headshots generated successfully or operation performed successfully.

data · array

The detail of the generated headshots.

success · boolean

Indicates if the task was successful executed.

task_id · string

The ID of the imagine task.