# 快速开始

准备 Key，选择模型，发起你的第一次图片请求。

## 01 / 准备 API Key

登录后在「我的 API Key」创建密钥，并确认账号余额、会员权益和模型权限。阅读文档无需登录。

```bash
export NOVEA_API_KEY="sk-your-key"
export REQUEST_ID="$(uuidgen)"
```

```powershell
$env:NOVEA_API_KEY = "sk-your-key"
$env:REQUEST_ID = [guid]::NewGuid().ToString()
```

## 02 / 确认可用模型

```bash
curl --fail-with-body 'https://noveadream.com/v1/models' \
  -H "Authorization: Bearer $NOVEA_API_KEY"
```

使用 data[].id 中的模型 ID。公开模型介绍不代表每个账号都能使用所有模型。

## 03 / 生成图片

```bash
curl --fail-with-body 'https://noveadream.com/v1/images/generations' \
  -H "Authorization: Bearer $NOVEA_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $REQUEST_ID" \
  -d '{
  "model": "gpt-image-2",
  "prompt": "A ceramic teapot on a sunlit table, soft shadows",
  "size": "1024x1024",
  "quality": "medium",
  "n": 1,
  "response_format": "url"
}'
```

网络重试复用 REQUEST_ID；新生成使用新的值。

## 04 / 保存结果

```json
{
  "created": 1791300000,
  "data": [
    {
      "url": "https://example.com/result.png"
    }
  ]
}
```

从 data[].url 下载成图。example.com 是示例占位地址。若返回 generation_pending，原任务仍可能执行中，请复用原幂等键，避免重复提交。