# 视频报价

POST /v1/videos/quote

## 认证

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

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

## 请求参数

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

## 返回字段

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

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

## 调用示例

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

### cURL

```bash
curl --request POST "https://api.storymo.art/v1/videos/quote" \
  --header "Authorization: Bearer $DRAMAGEN_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "seedance-2-fast",
  "prompt": "雨后的城市街道，镜头缓慢向前推进，路面倒映霓虹灯光",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'
```

### 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": "seedance-2-fast",
  "prompt": "雨后的城市街道，镜头缓慢向前推进，路面倒映霓虹灯光",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}
response = requests.request("POST", api_origin + "/v1/videos/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/videos/quote", {
  method: "POST",
  headers,
  body: JSON.stringify({
  "model": "seedance-2-fast",
  "prompt": "雨后的城市街道，镜头缓慢向前推进，路面倒映霓虹灯光",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}),
});
const result = await response.json();
if (!response.ok || result.code !== "ok") throw new Error(JSON.stringify(result));
console.log(result.data);
```
