Saltar al contenido principal
POST
/
v1
/
images
/
generations
Create image
curl --request POST \
  --url https://api.dgrid.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A cute baby sea otter wearing a beret",
  "model": "dall-e-3",
  "size": "1024x1024"
}
'
{
  "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
    }
  }
}
Esta página usa la misma operación images/generations que Crear imagen, con el playground de arriba rellenado previamente para el esquema genérico de imagen al estilo OpenAI (prompt, model, size, etc.). Las notas a continuación describen la forma de solicitud específica de Qwen para modelos de estilo wanx-v1.
Los modelos de imagen de Qwen aceptan una forma alternativa de solicitud que envuelve el prompt dentro de input.messages en lugar de usar un campo prompt de nivel superior. Proporcione model e input juntos en el cuerpo de la solicitud del playground para usar esta forma.

​
Campos de solicitud específicos de Qwen

CampoTipoObligatorioDescripción
modelstringSíIdentificador del modelo, como wanx-v1.
inputobjectSíObjeto contenedor de entrada enviado en la solicitud, usado en lugar de un prompt de nivel superior.
input.messagesarraySíMatriz de mensajes anidada dentro de input.
input.messages[].rolestringSíRol del mensaje, por ejemplo user.
input.messages[].contentstringSíTexto del prompt que describe la imagen deseada.
A diferencia de los campos estándar prompt / size / quality que se muestran en el playground, los modelos wanx-v1 de Qwen leen el prompt desde input.messages[].content. Otros campos de nivel superior como n y response_format no se usan en este formato.

​
Ejemplo: generar una imagen

{
  "model": "wanx-v1",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": "A serene mountain lake at dawn, photorealistic."
      }
    ]
  }
}

​
Campos de respuesta

La respuesta sigue la forma estándar de generación de imágenes:
​
created
integer
Marca de tiempo de creación.
​
data
array
Entradas de imagen generadas.

​
Ejemplo de respuesta

200
{
  "created": 1719859200,
  "data": [
    {
      "url": "https://cdn.dgrid.ai/generated/abc123.png",
      "b64_json": "",
      "revised_prompt": "A serene mountain lake at dawn with mist rising off the water, photorealistic."
    }
  ]
}

Autorizaciones

​
Authorization
string
header
requerido

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

Cuerpo

application/json
​
prompt
string
requerido

Image prompt.

​
model
string
predeterminado:dall-e-2

Model such as dall-e-2 or dall-e-3.

​
n
integer
predeterminado:1

Number of images to generate.

​
quality
enum<string>
predeterminado:standard
Opciones disponibles:
standard,
hd
​
response_format
enum<string>
predeterminado:url
Opciones disponibles:
url,
b64_json
​
size
string
predeterminado:1024x1024

Output size.

​
style
enum<string>
predeterminado:vivid
Opciones disponibles:
vivid,
natural
​
user
string

End-user identifier.

Respuesta

Generated images.

​
created
integer

Creation timestamp.

​
data
object[]

Generated image entries.

​
usage
object