通用接口

图片报价

Markdown
POSThttps://api.storymo.art/v1/images/quote

POST /v1/images/quote

认证

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

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

请求参数

参数类型必填说明
modelstring是具体模型页面中的模型 ID
resolutionstring否默认 2K,支持范围见该模型页面
aspect_ratiostring否默认 1:1,支持范围见该模型页面
promptstring否可传入最终生成描述,用于校验引用;省略时仅校验其他参数
referencesarray否与生成请求相同的参考素材;会校验文件归属和数量
max_creditsnumber否预计积分超过此值返回 budget_exceeded

返回字段

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

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

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"
}'
响应示例
{
  "code": "ok",
  "message": "success",
  "data": {
    "type": "image",
    "model": "Storymo-image-2",
    "credits": 5,
    "resolution": "2K",
    "aspect_ratio": "1:1",
    "charged": false
  },
  "requestId": "req_example"
}