> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Hunyuan Image 3

Hunyuan Image 3 是一款先进的文生图模型。只需提供文字描述，即可生成高质量、富有情感和故事性的图片，助力您的创意表达与艺术创作。

<Warning>
  本接口支持个人认证及企业认证用户调用。请参见 [实名认证](/support/identity-verification)，完成个人用户认证或企业用户认证，以确保可以正常使用本功能。
</Warning>

<Tip>
  这是一个**异步**API，只会返回异步任务的 task\_id。您应该使用该 task\_id 请求 [查询任务结果 API](/models/reference-get-async-task-result) 来检索生成结果。
</Tip>

## 请求头

<ParamField header="Content-Type" type="string" required={true}>
  枚举值: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer 身份验证格式，例如：Bearer \{\{API 密钥}}。
</ParamField>

## 请求体

<ParamField body="prompt" type="string" required={true}>
  正向提示词，用于指导图片生成内容。
</ParamField>

<ParamField body="size" type="string" required={false}>
  生成图片的尺寸，像素为宽\*高。每个维度范围 \[256 \~ 1536]，默认值为 `1024*1024`。
</ParamField>

<ParamField body="seed" type="integer" required={false}>
  随机种子。取值为 -1 时表示随机种子，取值范围为 \[-1 \~ 2147483647]，默认值为 `-1`。
</ParamField>

<ParamField body="watermark" type="boolean" required={false} default={false}>
  为生成的图像添加水印。

  * `false`：不添加水印。
  * `true`：在图像添加文字的水印，标识由人工智能生成合成。
</ParamField>

## 返回结果

<ResponseField name="task_id" type="string" required={true}>
  异步任务的 task\_id。您应该使用该 task\_id 请求 [查询任务结果 API](/models/reference-get-async-task-result) 以获取生成结果
</ResponseField>