跳转到主要内容
POST
/
prod-api
/
nebula
/
v4
/
api
/
img2imgSubmit
AI生图-图生图
curl --request POST \
  --url https://ai-nebula.com/prod-api/nebula/v4/api/img2imgSubmit \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "volcImageBo.imageUrl": "<string>",
  "volcImageBo.image_urls": {},
  "volcImageBo.prompt": "<string>",
  "volcImageBo.req_key": "<string>",
  "volcImageBo.return_url": true
}
'
{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "images": [{
      "url": "https://example.com/image.jpg"
    }]
  }
}

​
简介

提交图生图任务，用于根据输入图片生成新的图片。请求体使用 VolcImageDTO，根级为 volcImageBo 对象（与 OpenAPI 默认模块一致）。

​
认证

​
Authorization
string
必填
Bearer Token，如 Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9... 获取方法：依照左侧最上面认证模块的post接口获取，https://docs.openai-nebula.com/cn/nebula-lab-v4/endpoint/get-token

​
请求参数

请求体为 JSON，根级字段 volcImageBo 对应图生图参数对象。
​
volcImageBo.imageUrl
string
必填
图片链接（单图）
​
volcImageBo.image_urls
array[string]
图片 url 数组。0：输入图片（三通道 RGB）；1：输入 mask（单通道灰度，原图保持为 0/黑色，待消除区域为 255/白色）
​
volcImageBo.prompt
string
必填
提示词
​
volcImageBo.req_key
string
请求标识
​
volcImageBo.return_url
boolean
是否返回图片 URL

​
示例代码

curl -X POST "https://ai-nebula.com/prod-api/nebula/v4/api/img2imgSubmit" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "volcImageBo": {
      "imageUrl": "https://example.com/source.jpg",
      "image_urls": ["https://example.com/source.jpg"],
      "prompt": "变成油画风格",
      "req_key": "img2img_001",
      "return_url": true
    }
  }'

​
响应示例

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "images": [{
      "url": "https://example.com/image.jpg"
    }]
  }
}