Edición de imágenes Qwen

Edit image

curl --request POST \
  --url https://api.dgrid.ai/v1/images/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form image=@example-file \
  --form 'prompt=<string>' \
  --form mask=@example-file \
  --form 'model=<string>' \
  --form n=123 \
  --form 'size=<string>' \
  --form 'response_format=<string>' \
  --form 'user=<string>'

import requests

url = "https://api.dgrid.ai/v1/images/edits"

files = {
    "image": ("example-file", open("example-file", "rb")),
    "mask": ("example-file", open("example-file", "rb"))
}
payload = {
    "prompt": "<string>",
    "model": "<string>",
    "n": "123",
    "size": "<string>",
    "response_format": "<string>",
    "user": "<string>"
}
headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('image', '<string>');
form.append('prompt', '<string>');
form.append('mask', '<string>');
form.append('model', '<string>');
form.append('n', '123');
form.append('size', '<string>');
form.append('response_format', '<string>');
form.append('user', '<string>');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://api.dgrid.ai/v1/images/edits', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

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

func main() {

	url := "https://api.dgrid.ai/v1/images/edits"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"mask\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"n\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"size\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"response_format\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"user\"\r\n\r\n<string>\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dgrid.ai/v1/images/edits")
  .header("Authorization", "Bearer <token>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"mask\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"n\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"size\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"response_format\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"user\"\r\n\r\n<string>\r\n-----011000010111000001101001--")
  .asString();

{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>",
      "revised_prompt": "<string>"
    }
  ],
  "usage": {
    "total_tokens": 123,
    "input_tokens": 123,
    "output_tokens": 123,
    "input_tokens_details": {
      "text_tokens": 123,
      "image_tokens": 123
    }
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

POST

images

edits

Edit image

curl --request POST \
  --url https://api.dgrid.ai/v1/images/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form image=@example-file \
  --form 'prompt=<string>' \
  --form mask=@example-file \
  --form 'model=<string>' \
  --form n=123 \
  --form 'size=<string>' \
  --form 'response_format=<string>' \
  --form 'user=<string>'

import requests

url = "https://api.dgrid.ai/v1/images/edits"

files = {
    "image": ("example-file", open("example-file", "rb")),
    "mask": ("example-file", open("example-file", "rb"))
}
payload = {
    "prompt": "<string>",
    "model": "<string>",
    "n": "123",
    "size": "<string>",
    "response_format": "<string>",
    "user": "<string>"
}
headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('image', '<string>');
form.append('prompt', '<string>');
form.append('mask', '<string>');
form.append('model', '<string>');
form.append('n', '123');
form.append('size', '<string>');
form.append('response_format', '<string>');
form.append('user', '<string>');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://api.dgrid.ai/v1/images/edits', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

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

func main() {

	url := "https://api.dgrid.ai/v1/images/edits"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"mask\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"n\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"size\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"response_format\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"user\"\r\n\r\n<string>\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dgrid.ai/v1/images/edits")
  .header("Authorization", "Bearer <token>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"mask\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"n\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"size\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"response_format\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"user\"\r\n\r\n<string>\r\n-----011000010111000001101001--")
  .asString();

{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>",
      "revised_prompt": "<string>"
    }
  ],
  "usage": {
    "total_tokens": 123,
    "input_tokens": 123,
    "output_tokens": 123,
    "input_tokens_details": {
      "text_tokens": 123,
      "image_tokens": 123
    }
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

Esta página usa la misma operación images/edits que Editar imagen, con el playground de arriba rellenado previamente para el esquema genérico de edición al estilo OpenAI (image, mask, prompt, etc.). Las notas a continuación describen la forma de solicitud específica de Qwen para modelos de estilo wanx-v1.

Los modelos de edición de imágenes de Qwen aceptan una forma alternativa de solicitud JSON que envuelve las instrucciones de edición y las referencias de imagen de origen dentro de input.messages, en lugar de cargar archivos image / mask mediante datos de formulario multipart. Proporcione model e input juntos en el cuerpo de la solicitud del playground para usar esta forma.

Campos de solicitud específicos de Qwen

Campo	Tipo	Obligatorio	Descripción
`model`	string	Sí	Identificador del modelo, como `wanx-v1`.
`input`	object	Sí	Objeto contenedor enviado en el cuerpo de la solicitud, usado en lugar de los campos multipart `image` / `mask`.
`input.messages`	array	Sí	Matriz de mensajes anidada dentro de `input`.
`input.messages[].role`	string	Sí	Rol del mensaje, por ejemplo `user`.
`input.messages[].content`	string	Sí	Instrucciones de edición y cualquier imagen de origen referenciada.

Las imágenes de origen pueden referenciarse inline dentro de input.messages[].content (por ejemplo, como URL o referencias incrustadas) en lugar de cargarse como archivos multipart separados.

Ejemplo: editar una imagen

{
  "model": "wanx-v1",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": "Remove the background and replace it with a solid white backdrop."
      }
    ]
  }
}

Campos de respuesta

La respuesta sigue la forma estándar de edición de imágenes:

integer

Marca de tiempo de creación.

array

Entradas de imagen generadas.

Mostrar data item properties

string

URL de la imagen.

string

Carga útil de imagen en base64.

string

Prompt revisado devuelto por el modelo.

Ejemplo de respuesta

200

{
  "created": 1719859200,
  "data": [
    {
      "url": "https://cdn.dgrid.ai/generated/edited-abc123.png",
      "b64_json": "",
      "revised_prompt": "The subject with background removed and replaced with a solid white backdrop."
    }
  ]
}

Autorizaciones

Authorization

string

header

requerido

Your DGrid API key. All endpoints use Authorization: Bearer <DGRID_API_KEY>.

Cuerpo

image

file

requerido

Source image in PNG format, under 4 MB.

prompt

string

requerido

Editing instruction.

mask

file

Optional mask image.

model

string

Target image model.

integer

Number of outputs.

size

string

Output size.

response_format

string

Response format.

user

string

End-user identifier.

Respuesta

Edited images in the image generation response format.

created

integer

Creation timestamp.

data

object[]

Generated image entries.

Show child attributes

usage

object

Show child attributes

PRIMEROS PASOS

API DE MODELOS

API DE GESTIÓN

WEBHOOKS

API X402

Edición de imágenes Qwen

Campos de solicitud específicos de Qwen

Ejemplo: editar una imagen

Campos de respuesta

Ejemplo de respuesta

Autorizaciones

Cuerpo

Respuesta

​Campos de solicitud específicos de Qwen

​Ejemplo: editar una imagen

​Campos de respuesta

​Ejemplo de respuesta

Autorizaciones

Cuerpo

Respuesta

Campos de solicitud específicos de Qwen

Ejemplo: editar una imagen

Campos de respuesta

Ejemplo de respuesta