会话 Playground

POST /pg/images/edits

钱包 Playground 编辑图片

使用原生登录 access_token 直接扣减本人钱包编辑图片(支持 JSON 或 multipart/form-data,含 markup 文件)。multipart 重试保持有序部件头、文件名与文件字节一致,boundary 变化不影响意图指纹。

POST/pg/images/edits

身份验证

Authorizationstring必填

使用登录取得的 native access_token(身份要求:登录 access_token),按路由校验本人归属与受信任浏览器 Origin;生成写入按钱包规则扣费,只读查询不重新预扣;不得使用推理 API Key(sk-…)或 PAT(nap_…)。

Authorization: Bearer $ONEASTER_ACCESS_TOKEN

参数

Idempotency-Keystring

header · 每次新发起的 /pg 生成提交建议由前端生成并持久化稳定的 1–100 位无空格可打印 ASCII 标识(推荐 UUID),断线重试保持原标识与原请求字节。同账号跨所有 /pg POST 协议共用一个命名空间;省略时后端兼容生成并通过 X-OneAster-Intent-ID 返回,但若响应头丢失将无法按意图恢复。

请求正文 · application/json

modelstring必填

目录中的公开调用 ID(model_name),不能填写 display_name

promptstring必填

图片生成提示词

ninteger

生成张数(默认 1,上限 128)

sizestring

尺寸规格,如 1024x1024

qualitystring

画质档位,依模型能力而定

response_formatstring

返回格式,如 url 或 b64_json

output_formatstring

输出图片编码格式,依模型能力而定

backgroundstring

背景设置,依模型能力而定

watermarkboolean

可选水印开关

complexityanyOf

可选复杂度或档位(字符串或整数,显式 0 保留并原样转发;依模型和渠道能力而定)

markupanyOf

可选标注输入(对象或布尔值,显式 false 保留并原样转发)

svganyOf

可选 SVG 扩展配置(对象或布尔值,显式 false 保留并原样转发)

frame_countinteger

可选帧数(显式 0 保留并原样转发;依模型和渠道能力而定)

frame_duration_msinteger

可选单帧时长毫秒(显式 0 保留并原样转发;依模型和渠道能力而定)

JSON Schema
{
  "type": "object",
  "required": [
    "model",
    "prompt"
  ],
  "properties": {
    "model": {
      "type": "string",
      "description": "目录中的公开调用 ID(model_name),不能填写 display_name"
    },
    "prompt": {
      "type": "string",
      "description": "图片生成提示词"
    },
    "n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 128,
      "description": "生成张数(默认 1,上限 128)"
    },
    "size": {
      "type": "string",
      "description": "尺寸规格,如 1024x1024"
    },
    "quality": {
      "type": "string",
      "description": "画质档位,依模型能力而定"
    },
    "response_format": {
      "type": "string",
      "description": "返回格式,如 url 或 b64_json"
    },
    "output_format": {
      "type": "string",
      "description": "输出图片编码格式,依模型能力而定"
    },
    "background": {
      "type": "string",
      "description": "背景设置,依模型能力而定"
    },
    "watermark": {
      "type": "boolean",
      "description": "可选水印开关"
    },
    "complexity": {
      "description": "可选复杂度或档位(字符串或整数,显式 0 保留并原样转发;依模型和渠道能力而定)",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "integer"
        }
      ]
    },
    "markup": {
      "description": "可选标注输入(对象或布尔值,显式 false 保留并原样转发)",
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "boolean"
        }
      ]
    },
    "svg": {
      "description": "可选 SVG 扩展配置(对象或布尔值,显式 false 保留并原样转发)",
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "boolean"
        }
      ]
    },
    "frame_count": {
      "type": "integer",
      "minimum": 0,
      "description": "可选帧数(显式 0 保留并原样转发;依模型和渠道能力而定)"
    },
    "frame_duration_ms": {
      "type": "integer",
      "minimum": 0,
      "description": "可选单帧时长毫秒(显式 0 保留并原样转发;依模型和渠道能力而定)"
    }
  },
  "additionalProperties": true
}

请求正文 · multipart/form-data

modelstring必填

目录中的公开调用 ID(model_name),不能填写 display_name

promptstring必填

编辑提示词

imagestring

待编辑原图文件

maskstring

可选遮罩图片文件

markupstring

可选标注图片文件(原样转发)

complexitystring

可选复杂度字段

ninteger
sizestring
response_formatstring
JSON Schema
{
  "type": "object",
  "required": [
    "model",
    "prompt"
  ],
  "properties": {
    "model": {
      "type": "string",
      "description": "目录中的公开调用 ID(model_name),不能填写 display_name"
    },
    "prompt": {
      "type": "string",
      "description": "编辑提示词"
    },
    "image": {
      "type": "string",
      "format": "binary",
      "description": "待编辑原图文件"
    },
    "mask": {
      "type": "string",
      "format": "binary",
      "description": "可选遮罩图片文件"
    },
    "markup": {
      "type": "string",
      "format": "binary",
      "description": "可选标注图片文件(原样转发)"
    },
    "complexity": {
      "type": "string",
      "description": "可选复杂度字段"
    },
    "n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 128
    },
    "size": {
      "type": "string"
    },
    "response_format": {
      "type": "string"
    }
  },
  "additionalProperties": true
}