# 图片报价

POST /v1/images/quote

## 认证

请求头 Authorization: Bearer YOUR_API_KEY。API Key 可在网站“开发者 API”页面创建。

请求头 Content-Type: application/json。无需 Idempotency-Key。

## 请求参数

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| model | string | 是 | 具体模型页面中的模型 ID |
| resolution | string | 否 | 默认 2K，支持范围见该模型页面 |
| aspect_ratio | string | 否 | 默认 1:1，支持范围见该模型页面 |
| prompt | string | 否 | 可传入最终生成描述，用于校验引用；省略时仅校验其他参数 |
| references | array | 否 | 与生成请求相同的参考素材；会校验文件归属和数量 |
| max_credits | number | 否 | 预计积分超过此值返回 budget_exceeded |

## 返回字段

- credits：预计积分。
- charged：固定 false，报价不扣费。
- type、model、resolution、aspect_ratio：本次报价参数。

实际提交时按当前账户和模型配置计算积分。报价不创建任务、不锁定价格或预留余额。

## 调用示例

设置环境变量 DRAMAGEN_API_KEY（用户密钥）。Python 需要 requests，JavaScript 使用 Node.js 20+。

### cURL

```bash
curl --request POST "https://api.storymo.art/v1/images/quote" \
  --header "Authorization: Bearer $DRAMAGEN_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "Storymo-image-2",
  "prompt": "一只橘猫坐在窗边，柔和的晨光，细腻的毛发",
  "aspect_ratio": "1:1",
  "resolution": "2K"
}'
```

### Python

```python
import os
import requests

api_origin = "https://api.storymo.art"
headers = {
  "Authorization": "Bearer YOUR_API_KEY",
  "Content-Type": "application/json"
}
headers["Authorization"] = "Bearer " + os.environ["DRAMAGEN_API_KEY"]
body = {
  "model": "Storymo-image-2",
  "prompt": "一只橘猫坐在窗边，柔和的晨光，细腻的毛发",
  "aspect_ratio": "1:1",
  "resolution": "2K"
}
response = requests.request("POST", api_origin + "/v1/images/quote", headers=headers, json=body, timeout=360)
response.raise_for_status()
result = response.json()
if result["code"] != "ok":
    raise RuntimeError(result)
print(result["data"])
```

### JavaScript

```javascript
const apiOrigin = "https://api.storymo.art";
const headers = {
  "Authorization": "Bearer YOUR_API_KEY",
  "Content-Type": "application/json"
};
headers.Authorization = `Bearer ${process.env.DRAMAGEN_API_KEY}`;
const response = await fetch(apiOrigin + "/v1/images/quote", {
  method: "POST",
  headers,
  body: JSON.stringify({
  "model": "Storymo-image-2",
  "prompt": "一只橘猫坐在窗边，柔和的晨光，细腻的毛发",
  "aspect_ratio": "1:1",
  "resolution": "2K"
}),
});
const result = await response.json();
if (!response.ok || result.code !== "ok") throw new Error(JSON.stringify(result));
console.log(result.data);
```
