# Generate  3.0（文生图） 

**方法**: `POST`
**路径**: `/ideogram/v1/ideogram-v3/generate`

使用 Ideogram 3.0 模型，根据给定的提示和可选参数同步生成图像
具体参数请看官方文档：<https://developer.ideogram.ai/api-reference/api-reference/generate-v3>

返回的图像 URL 在 24 小时内有效，超过该时间将无法访问图像。
已反代图片

## 请求参数

### Header 参数

```text
accept
string
必需
示例:
application/json
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}
```

### Body 参数 multipart/form-data

```text
prompt
string
必需
rendering_speed
string
可选
character_reference_images
file
可选
带 character 一致性，支持多图
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/ideogram/v1/ideogram-v3/generate' \
--header 'accept: application/json' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--form 'prompt=""' \
--form 'rendering_speed=""' \
--form 'character_reference_images=@""'
```

## 返回响应

### 🔴 500 成功

**内容类型**: `application/json`

#### 响应结构

```text
code
string
必需
message
string
必需
data
null
必需
```

#### 示例

```json
{
    "created": "2000-01-23 04:56:07+00:00",
    "data": [
        {
            "prompt": "A photo of a cat sleeping on a couch.",
            "resolution": "1024x1024",
            "is_image_safe": true,
            "seed": 12345,
            "url": "https://ideogram.ai/api/images/ephemeral/xtdZiqPwRxqY1Y7NExFmzB.png?exp=1743867804&sig=e13e12677633f646d8531a153d20e2d3698dca9ee7661ee5ba4f3b64e7ec3f89",
            "style_type": "GENERAL"
        }
    ]
}
```