Portrait (Result Acquisition) - 302.AI API Document

Image-to-Image 3.0 - Portrait Photography Task Acquisition

Price: Free

Request

Query Params

response_format

string

optional

Default data is the original data; by providing a URL, you can obtain data from the URL.

Example:

url

Header Params

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

task_id

string

required

Task ID, the value of this field is returned by the submit task interface

req_json

string

optional

String after JSON serialization
Currently supports watermark configuration and whether to return as an image link, which can be added in the return result.

LogoInfo
Watermark related information

return_url Optional bool Output whether to return an image link (the link is valid for 24 hours)
logo_info Optional LogoInfo Watermark information
add_logo Boolean No Whether to add a watermark. True to add, False not to add. Default is not to add
position Int No Position of the watermark, values are as follows:
0 - Bottom right
1 - Bottom left
2 - Top left
3 - Top right
Default is 0
language Int No Language of the watermark, values are as follows:
0 - Chinese (AI生成)
1 - English (Generated by AI)
Default is 0

opacity Float No Opacity of the watermark, value range 0-1, 1 means fully opaque, default is 0.3

Example

{
    "task_id": "6682608976809320374",
    "req_json": "{\"logo_info\":{\"add_logo\":true,\"position\":0,\"language\":0,\"opacity\":0.3,\"logo_text_content\":\"这里是明水印内容\"},\"return_url\":true}"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200成功

application/json

Body

code

integer

required

data

object

required

algorithm_base_resp

object

required

binary_data_base64

array[string]

required

image_urls

array[string]

required

resp_data

string

required

comfyui_cost

string

required

image_output

null

required

log_output

string

required

status

string

required

message

string

required

request_id

string

required

status

integer

required

time_elapsed

string

required

Example

{
    "code": 10000,
    "data": {
        "algorithm_base_resp": {
            "status_code": 0,
            "status_message": ""
        },
        "binary_data_base64": [],
        "image_urls": [
            "https://file.302.ai/gpt/imgs/20250704/294e21f5c461495a9d1d11328691a2d6.png"
        ],
        "resp_data": "{\"log_output\": \"{\\\"infer_ctx\\\":{\\\"algorithm_key\\\":\\\"high_aes_scheduler_general_v3.0_18b\\\",\\\"app_key\\\":\\\"2101629922\\\",\\\"created_at\\\":\\\"2025-07-04T13:37:22.292838105+08:00\\\",\\\"generate_id\\\":\\\"\\\",\\\"log_id\\\":\\\"20250704133711F5C61AE75EC8D72B6490\\\",\\\"params\\\":{\\\"app_id\\\":\\\"\\\",\\\"aspect_ratio\\\":\\\"\\\",\\\"common_params\\\":\\\"\\\",\\\"ddim_steps\\\":6,\\\"edit_session_id\\\":\\\"\\\",\\\"fps\\\":0,\\\"frames\\\":0,\\\"group_name\\\":\\\"\\\",\\\"height\\\":1327,\\\"input_image_url\\\":\\\"\\\",\\\"is_only_sr\\\":false,\\\"is_pe\\\":true,\\\"llm_result\\\":\\\"\\\",\\\"media_source\\\":\\\"\\\",\\\"n_samples\\\":0,\\\"negative_prompt\\\":\\\"text，国旗，national flag,Low resolution, blurry, the worst quality，假小子，半男半女，小红书水印\\\",\\\"ori_prompt\\\":\\\"一张东亚人种年轻男性的特写肖像图，面容清秀。 长出满脸的胡子\\\",\\\"origin_request_id\\\":\\\"\\\",\\\"output_height\\\":1327,\\\"output_width\\\":1327,\\\"pe_result\\\":\\\"特写肖像，暖色调，一位东亚人种年轻男性，面容清秀，穿着衬衫，长出满脸的胡子，皮肤细腻光滑，胡子浓密，近景，柔和光影。\\\",\\\"predict_tags_result\\\":\\\"\\\",\\\"rephraser_result\\\":\\\"\\\",\\\"req_key\\\":\\\"high_aes_general_v30l\\\",\\\"rescale\\\":0,\\\"resolution\\\":\\\"\\\",\\\"scale\\\":0,\\\"seed\\\":366947886,\\\"shift\\\":0,\\\"sr_img2img_fix_steps\\\":0,\\\"sr_scale\\\":0,\\\"sr_strength\\\":0,\\\"sr_upscaler\\\":\\\"\\\",\\\"steps\\\":0,\\\"strength\\\":0,\\\"trace_id\\\":\\\"\\\",\\\"translate_negative_prompt\\\":\\\"text，国旗，national flag,Low resolution, blurry, the worst quality，假小子，半男半女，小红书水印\\\",\\\"translate_prompt\\\":\\\"一张东亚人种年轻男性的特写肖像图，面容清秀。 长出满脸的胡子\\\",\\\"use_pre_llm\\\":false,\\\"use_prompt_aug\\\":false,\\\"use_sr\\\":false,\\\"version_id\\\":\\\"\\\",\\\"video_url\\\":\\\"\\\",\\\"vlm_edit\\\":\\\"\\\",\\\"vlm_input\\\":\\\"\\\",\\\"vlm_output\\\":\\\"\\\",\\\"width\\\":1327},\\\"request_id\\\":\\\"433e25f298d697303ce36a7ae51c5ed51e6e5220c9dc0e2cde30690d5f91f692\\\",\\\"session_id\\\":\\\"\\\",\\\"time_stamp\\\":\\\"1751607442\\\"},\\\"llm_result\\\":\\\"特写肖像，暖色调，一位东亚人种年轻男性，面容清秀，穿着衬衫，长出满脸的胡子，皮肤细腻光滑，胡子浓密，近景，柔和光影。\\\",\\\"pe_result\\\":\\\"特写肖像，暖色调，一位东亚人种年轻男性，面容清秀，穿着衬衫，长出满脸的胡子，皮肤细腻光滑，胡子浓密，近景，柔和光影。\\\",\\\"predict_tags_result\\\":\\\"\\\",\\\"rephraser_result\\\":\\\"\\\",\\\"request_id\\\":\\\"433e25f298d697303ce36a7ae51c5ed51e6e5220c9dc0e2cde30690d5f91f692\\\",\\\"vlm_result\\\":\\\"\\\"}\", \"image_output\": [\"uri://binary_data?index=0\"], \"comfyui_cost\": 21.3237}",
        "comfyui_cost": "",
        "image_output": null,
        "log_output": "",
        "status": "done"
    },
    "message": "Success",
    "request_id": "20250704135505CC9722EC8585EC323E03",
    "status": 10000,
    "time_elapsed": "925.911462ms"
}