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

​
简介

提交文生图任务，用于根据文本描述生成新的图片。

​
认证

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

​
请求参数

请求体为 JSON，根级字段 req 对应示例中的 "req" 对象。
​
req.prompt
string
必填
图片描述提示词
​
req.size
string
必填
图片尺寸，如：512x512, 1024x1024
​
req.value
string
必填
图片尺寸枚举值，与 size 一致即可，如：1024x1024
​
req.req_key
string
必填
请求标识，用于业务侧关联与去重
​
req.return_url
boolean
是否返回图片 URL
​
req.width
integer
图片宽度。推荐 1.3K 左右分辨率；宽高乘积小于 2048×2048 均可出图
​
req.height
integer
图片高度。推荐 1.3K 左右分辨率；宽高乘积小于 2048×2048 均可出图

​
示例代码

curl -X POST "https://ai-nebula.com/prod-api/nebula/v4/api/text2imageSubmit" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "req": {
      "prompt": "一只可爱的小猫在草地上玩耍",
      "size": "1024x1024",
      "value": "1024x1024",
      "req_key": "req-001",
      "return_url": true,
      "width": 1024,
      "height": 1024
    }
  }'

​
响应示例

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