创建图片 (Create Image)

使用通义千问模型创建图片。

请求

POST https://www.realmrouter.cn/v1/images/generations

请求头

参数	类型	必填	说明
Authorization	string	是	Bearer Token 认证。格式: `Authorization: Bearer sk-xxxxxx`
Content-Type	string	是	请求内容类型，固定为 `application/json`

请求体 (application/json)

参数	类型	必填	说明
model	string	是	模型名称，可选值: `qwen-image` \| `qwen-image-plus`
input	object	是	输入参数对象
input.messages	array	是	消息数组
input.messages[].role	string	是	消息角色，固定为 `"user"`
input.messages[].content	array	是	内容数组
input.messages[].content[].type	string	是	内容类型，固定为 `"text"`
input.messages[].content[].text	string	是	图片生成提示词
parameters	object	否	生成参数对象
parameters.negative_prompt	string	否	负面提示词，用于指定不希望出现的内容
parameters.prompt_extend	boolean	否	是否扩展提示词，默认值: `true`
parameters.watermark	boolean	否	是否添加水印，默认值: `false`
parameters.size	string	否	图片尺寸，默认值: `"1328*1328"`

请求示例

cURL

bash

curl -X POST "https://www.realmrouter.cn/v1/images/generations" \
  -H "Authorization: Bearer " \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-plus",
    "input": {
      "messages": [
        {
          "role": "user",
          "content": [
            {
              "type": "text",
              "text": "一只可爱的猫咪"
            }
          ]
        }
      ]
    },
    "parameters": {
      "negative_prompt": "",
      "prompt_extend": true,
      "watermark": false,
      "size": "1328*1328"
    }'

JavaScript

javascript

const body = JSON.stringify({
  "model": "qwen-image-plus",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "一只可爱的猫咪"
          }
        ]
      }
    ]
  },
  "parameters": {
    "negative_prompt": "",
    "prompt_extend": true,
    "watermark": false,
    "size": "1328*1328"
  }
})

fetch("https://www.realmrouter.cn/v1/images/generations", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer "
  },
  body
})

Go

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
  "strings"
)

func main() {
  url := "https://www.realmrouter.cn/v1/images/generations"
  body := strings.NewReader(`{
    "model": "qwen-image-plus",
    "input": {
      "messages": [
        {
          "role": "user",
          "content": [
            {
              "type": "text",
              "text": "一只可爱的猫咪"
            }
          ]
        }
      ]
    },
    "parameters": {
      "negative_prompt": "",
      "prompt_extend": true,
      "watermark": false,
      "size": "1328*1328"
    }
  }`)
  req, _ := http.NewRequest("POST", url, body)
  req.Header.Add("Authorization", "Bearer ")
  req.Header.Add("Content-Type", "application/json")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}

Python

python

import requests

url = "https://www.realmrouter.cn/v1/images/generations"
body = """{
  "model": "qwen-image-plus",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "一只可爱的猫咪"
          }
        ]
      }
    ]
  },
  "parameters": {
    "negative_prompt": "",
    "prompt_extend": true,
    "watermark": false,
    "size": "1328*1328"
  }
}"""
response = requests.request("POST", url, data = body, headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer "
})

print(response.text)

Java

java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import java.time.Duration;
import java.net.http.HttpRequest.BodyPublishers;

var body = BodyPublishers.ofString("""{
  "model": "qwen-image-plus",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "一只可爱的猫咪"
          }
        ]
      }
    ]
  },
  "parameters": {
    "negative_prompt": "",
    "prompt_extend": true,
    "watermark": false,
    "size": "1328*1328"
  }
}""");
HttpClient client = HttpClient.newBuilder()
  .connectTimeout(Duration.ofSeconds(10))
  .build();

HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
  .uri(URI.create("https://www.realmrouter.cn/v1/images/generations"))
  .header("Authorization", "Bearer ")
  .header("Content-Type", "application/json")
  .POST(body)
  .build();

try {
  HttpResponse<String> response = client.send(requestBuilder.build(), BodyHandlers.ofString());
  System.out.println("Status code: " + response.statusCode());
  System.out.println("Response body: " + response.body());
} catch (Exception e) {
  e.printStackTrace();
}

C#

csharp

using System;
using System.Net.Http;
using System.Text;

var body = new StringContent("""
{
  "model": "qwen-image-plus",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "一只可爱的猫咪"
          }
        ]
      }
    ]
  },
  "parameters": {
    "negative_prompt": "",
    "prompt_extend": true,
    "watermark": false,
    "size": "1328*1328"
  }
}
""", Encoding.UTF8, "application/json");

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer ");
var response = await client.PostAsync("https://www.realmrouter.cn/v1/images/generations", body);
var responseBody = await response.Content.ReadAsStringAsync();

响应

响应体 (application/json)

参数	类型	说明
created	integer	创建时间戳
data	array	生成的图片数据数组
data[].url	string	图片URL
data[].revised_prompt	string	修订后的提示词

响应示例

json

{
  "created": 1234567890,
  "data": [
    {
      "url": "https://example.com/image.png",
      "revised_prompt": "一只可爱的猫咪"
    }
  ]
}

状态码

状态码	说明
200	成功
400	请求参数错误
401	认证失败
429	请求过于频繁
500	服务器错误

注意事项

model 参数支持两个模型：
- qwen-image: 基础图片生成模型
- qwen-image-plus: 增强版图片生成模型，推荐使用
input.messages[].content[].text 参数是图片生成的核心，建议使用清晰、具体的描述
parameters.negative_prompt 参数用于指定不希望出现的内容，可以提升生成质量
parameters.prompt_extend 参数控制是否自动扩展提示词：
- true: 自动扩展提示词以获得更好的效果
- false: 使用原始提示词
parameters.watermark 参数控制是否添加水印：
- true: 添加水印
- false: 不添加水印
parameters.size 参数控制图片尺寸，默认为 "1328*1328"
每次请求的token消耗会计入您的配额
推荐使用 qwen-image-plus 模型以获得最佳图片生成效果
生成的图片URL有时效性，请及时保存
图片生成可能需要较长时间，请耐心等待响应

创建图片 (Create Image) ​

请求 ​

请求头 ​

请求体 (application/json) ​

请求示例 ​

cURL ​

JavaScript ​

Go ​

Python ​

Java ​

C# ​

响应 ​

响应体 (application/json) ​

响应示例 ​

状态码 ​

注意事项 ​

创建图片 (Create Image)

请求

请求头

请求体 (application/json)

请求示例

cURL

JavaScript

Go

Python

Java

C#

响应

响应体 (application/json)

响应示例

状态码

注意事项