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

# 图片生成介绍

> 图片生成能力总览

export const PlatformLink = ({href, children}) => {
  const MOBILE_MAX_WIDTH = 768;
  const TOAST_TEXT = '为了更好的支付体验，请在电脑端进行操作';
  const TOAST_DURATION_MS = 2400;
  const [toastVisible, setToastVisible] = useState(false);
  const hideTimerRef = useRef(0);
  useEffect(() => {
    return () => {
      if (hideTimerRef.current) clearTimeout(hideTimerRef.current);
    };
  }, []);
  const handleClick = event => {
    const isMobile = typeof window !== 'undefined' && window.matchMedia(`(max-width: ${MOBILE_MAX_WIDTH - 1}px)`).matches;
    if (!isMobile) return;
    event.preventDefault();
    event.stopPropagation();
    setToastVisible(true);
    if (hideTimerRef.current) clearTimeout(hideTimerRef.current);
    hideTimerRef.current = window.setTimeout(() => {
      setToastVisible(false);
    }, TOAST_DURATION_MS);
  };
  return <>
      <a href={href} onClick={handleClick} target="_blank" rel="noreferrer" className="text-primary">
        {children}
      </a>
      {toastVisible && <div role="status" aria-live="polite" className="fixed left-1/2 bottom-20 -translate-x-1/2 max-w-[calc(100vw-32px)] px-5 py-3 bg-black/85 text-white text-sm leading-normal rounded-lg shadow-lg z-[99999] text-center pointer-events-none">
          {TOAST_TEXT}
        </div>}
    </>;
};

SenseAudio 图片生成服务面向海报设计、营销素材、电商主图、角色概念图等场景，提供统一的图片生成 API。开发者可以通过自然语言提示词快速生成图片，也可以配合参考图进行风格约束，满足从快速草图到高分辨率成品图的不同需求。

## 什么是图片生成

图片生成能力允许您通过文本描述直接生成图片内容。平台当前同时提供同步与异步两种调用方式：

* **同步生成**：适合对实时返回要求较高的场景，接口直接返回图片 URL。
* **异步生成**：适合更稳定的任务式处理流程，先创建任务，再轮询获取结果。
* **双模型支持**：同一套接口支持不同生成模型，方便在画质、尺寸和效率之间灵活取舍。
* **参考图输入**：支持传入参考图 URL 或 Data URI，对构图与风格进行约束。

## 核心特性

### 文本直出图片

只需提供 `prompt` 即可完成文生图，适合批量素材生成、概念草图探索和视觉创意验证。

### 多尺寸输出

不同模型支持不同尺寸，既可以满足常规海报、封面图需求，也可以覆盖高分辨率营销素材场景。

### 同步与异步双模式

您可以根据业务形态选择合适的调用方式：同步模式适合即时展示，异步模式更适合任务队列与后台批处理。

## 模型支持

| 模型                              | 特点                                                       | 适用场景                  |
| :------------------------------ | :------------------------------------------------------- | :-------------------- |
| **senseaudio-image-2.0-260319** | 自研图片生成最新版本，支持多种宽高比与高分辨率输出                                | 高清营销主图、社媒大图、宽屏视觉素材    |
| **senseaudio-image-1.0-260319** | 常规图片生成模型，覆盖主流横版、竖版和方图尺寸                                  | 常规营销图、封面图、内容配图        |
| **doubao-seedream-5-0-260128**  | 支持更大尺寸输出，更适合高分辨率生成                                       | 宣传海报、电商物料、精细大图        |
| **sensenova-u1-fast**           | 基于 SenseNova U1 的加速版本，理解与生成一体，面向信息图生成优化，擅长高密度信息表达与丰富版式排版 | 信息图表、PPT 页面、高密度视觉内容生成 |

## API 能力概览

SenseAudio 图片生成提供以下核心接口：

### 1. 异步图片生成

调用后返回 `task_id`，适合生成任务需要排队、轮询或后台处理的场景。

* 文档：**[异步图片生成](/api-reference/endpoint/image/async)**
* 接口地址：`POST https://api.senseaudio.cn/v1/image/async`

### 2. 异步图片获取

根据 `task_id` 查询任务状态与最终结果，适合与异步生成接口配合使用。

* 文档：**[异步图片获取](/api-reference/endpoint/image/pending)**
* 接口地址：`GET https://api.senseaudio.cn/v1/image/pending`

### 3. 同步图片生成

调用成功后直接返回图片 URL，适合需要即时展示生成结果的页面交互场景。

* 文档：**[同步图片生成](/api-reference/endpoint/image/sync)**
* 接口地址：`POST https://api.senseaudio.cn/v1/image/sync`

## 接口选择建议

| 场景            | 推荐接口                                  | 说明                             |
| :------------ | :------------------------------------ | :----------------------------- |
| 前端即时出图        | 同步图片生成                                | 调用简单，直接返回结果                    |
| 后台批量生成        | 异步图片生成 + 异步图片获取                       | 便于任务管理和轮询                      |
| 高清宽屏与多比例输出    | 同步或异步 + `senseaudio-image-2.0-260319` | 支持横版、竖版与超宽尺寸的高分辨率输出            |
| 高分辨率物料生成      | 同步或异步 + `doubao-seedream-5-0-260128`  | 支持更大尺寸输出                       |
| 常规内容配图        | 同步或异步 + `senseaudio-image-1.0-260319` | 兼顾效率与通用性                       |
| 信息图与 PPT 页面生成 | 同步或异步 + `sensenova-u1-fast`           | 专供信息图生成，适合高密度信息表达、图文排版和结构化视觉内容 |

## 计费说明

请参考 **[计费规则](/guides/account/billing)**。

## 典型应用场景

### 电商与营销设计

用于商品主图、活动海报、广告素材、社媒封面等高频视觉内容生产。

### 内容创作与媒体配图

用于文章插图、短视频封面、播客封面、专题视觉图等内容制作场景。

### 游戏与角色概念设计

用于角色设定图、世界观草图、场景概念图和风格探索阶段的创作提效。

## 开始使用

<Steps>
  <Step title="进入 API 密钥">
    进入 [API 密钥](https://senseaudio.cn/api-platform/api-key) 页面。
  </Step>

  <Step title="新增并保存 API Key">
    点击 **"新增 API Key"**，复制并安全保存您的 API Key。
  </Step>
</Steps>

## 相关资源

<CardGroup cols={2}>
  <Card title="同步图片生成" icon="image" href="/api-reference/endpoint/image/sync">
    即时返回图片 URL，适合前端展示。
  </Card>

  <Card title="异步图片生成" icon="layer-group" href="/api-reference/endpoint/image/async">
    返回 `task_id`，适合后台批量生产。
  </Card>

  <Card title="异步图片获取" icon="clock" href="/api-reference/endpoint/image/pending">
    根据 `task_id` 查询任务状态与结果。
  </Card>

  <Card title="计费规则" icon="credit-card" href="/guides/account/billing">
    查看图片生成的积分消耗规则。
  </Card>
</CardGroup>