Docs
我的 API Key ↗EN
开发文档/开始使用

快速开始

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

更新于 2026 年 10 月 7 日查看 Markdown ↗

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 / 确认可用模型

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

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

03 / 生成图片

POST /v1/images/generations
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，原任务仍可能执行中，请复用原幂等键，避免重复提交。