QwenComprobando

Qwen Image 3.0 Pro / Image Edit

qwen-image-3-0-pro-image-edit

imagen a imagenSalida: ImagenEntrada: texto + imagen

Cargando precio…

Precio de lista oficial · Sin verificar

Obtener clave de API

Parámetros

Obligatorio

imageUrlsimageUrls: string[]

Arrastra imágenes aquí o haz clic para subirlasHasta 3 archivos

Input images (1-3), ordered by array position. Public URLs, OSS temporary URLs, and Base64 are supported. Recommended size: 384-2048px, max 10MB per image. ≤ 3 items · HTTPS image URL or media:<uuid>

promptprompt: string

Image editing instruction describing what to preserve, replace, redraw, or enhance. Chinese and English are supported. ≤ 3000 chars

Opciones comunes

sizesize: string

Output resolution as width*height. Total pixels must be within 512*512 to 2048*2048. Labels 1k/2k denote resolution tier. Leave empty to let the model choose from the prompt. 262144–4194304 pixels; width*height · Aspect ratio 1:8–8:1

imageNumimageNum: integer

Number of images generated per request. Defaults to 1.

promptExtendModepromptExtendMode: string

Prompt rewriting mode, effective only when promptExtend is enabled. Use direct for direct rewriting or agent for agent-based rewriting.

Avanzado (4)

negativePromptnegativePrompt: string

Negative prompt describing unwanted content. ≤ 600 chars

promptExtendpromptExtend: boolean

Whether to enable intelligent prompt rewriting. Enabled by default; improves results for short editing instructions.

enableThinkingenableThinking: boolean

Enable thinking mode for prompt rewriting. On by default: better quality, slower. Turn off to cut rewrite time to about 20s. Only takes effect when promptExtend=true. Supported for Direct I2I; not supported when promptExtendMode=agent.

seedseed: integer

Random seed in [0, 2147483647]. Fixing the seed reproduces results; leave empty for random. 0–2147483647

Vista previa de la solicitud

{
  "model": "qwen-image-3-0-pro-image-edit",
  "input": {
    "imageNum": 1,
    "promptExtend": true,
    "promptExtendMode": "direct",
    "enableThinking": true
  }
}

El playground web envía este cuerpo con tu sesión iniciada. Desde código, envía el mismo cuerpo con una clave de API.

Cargo estimado

Cargando precio…

Los créditos se reservan al aceptar una tarea y solo se cobran si tiene éxito. Las tareas fallidas liberan la reserva; los resultados sin confirmar siguen reservados hasta verificarse.

Qué hace

Edit images with text instructions.

Image editing · 1–6 images

Parámetros de entrada

Solo los campos que acepta este modelo. Los campos obligatorios deben indicarse.

Campo	Tipo	Obligatorio	Predeterminado	Valores permitidos y restricciones
`imageUrls`	`string[]`	obligatorio	—	Input images (1-3), ordered by array position. Public URLs, OSS temporary URLs, and Base64 are supported. Recommended size: 384-2048px, max 10MB per image. ≤ 3 items · HTTPS image URL or media:<uuid>
`prompt`	`string`	obligatorio	—	Image editing instruction describing what to preserve, replace, redraw, or enhance. Chinese and English are supported. ≤ 3000 chars
`negativePrompt`	`string`	opcional	—	Negative prompt describing unwanted content. ≤ 600 chars
`size`	`string`	opcional	—	Output resolution as widthheight. Total pixels must be within 512512 to 20482048. Labels 1k/2k denote resolution tier. Leave empty to let the model choose from the prompt. Uno de: `"10241024"`, `"16001600"`, `"7681152"`, `"12801920"`, `"1152768"`, `"19201280"`, `"7681024"`, `"15362048"`, `"1024768"`, `"17921344"`, `"5761024"`, `"11522048"`, `"1024576"`, `"20481152"` 262144–4194304 pixels; widthheight · Aspect ratio 1:8–8:1
`imageNum`	`integer`	opcional	`1`	Number of images generated per request. Defaults to 1. Uno de: `1`, `2`, `3`, `4`, `5`, `6`
`promptExtend`	`boolean`	opcional	`true`	Whether to enable intelligent prompt rewriting. Enabled by default; improves results for short editing instructions.
`promptExtendMode`	`string`	opcional	`"direct"`	Prompt rewriting mode, effective only when promptExtend is enabled. Use direct for direct rewriting or agent for agent-based rewriting. Uno de: `"direct"`, `"agent"`
`enableThinking`	`boolean`	opcional	`true`	Enable thinking mode for prompt rewriting. On by default: better quality, slower. Turn off to cut rewrite time to about 20s. Only takes effect when promptExtend=true. Supported for Direct I2I; not supported when promptExtendMode=agent.
`seed`	`integer`	opcional	—	Random seed in [0, 2147483647]. Fixing the seed reproduces results; leave empty for random. 0–2147483647

Límites y comportamiento

Solo asíncrono: envía una tarea y luego consulta el resultado.
imageUrls: ≤ 3 items
prompt: ≤ 3000 chars
negativePrompt: ≤ 600 chars
size: 262144–4194304 pixels; width*height, Aspect ratio 1:8–8:1
seed: 0–2147483647
Las entradas multimedia aceptan URL HTTPS públicas o referencias media:<uuid> de POST /api/v1/media.

Endpoint

Todos los modelos comparten una API de tareas asíncrona. Este modelo se selecciona por su slug.

Enviar

POST https://api.hermes-ai.net/api/v1/jobs

{
  "model": "qwen-image-3-0-pro-image-edit",
  "input": {
    "imageUrls": [
      "https://example.com/input.png"
    ],
    "prompt": "A lighthouse on a rocky coast at sunrise, soft light"
  }
}

Después consulta GET /api/v1/jobs/{id} hasta que el estado sea final.

Autenticación

Envía una clave de API con el permiso jobs:create para enviar y jobs:read para consultar.

Encabezado	Valor	Notas
`Authorization`	`Bearer <API key>`	O envía la clave en x-api-key.
`Content-Type`	`application/json`
`Idempotency-Key`	`<unique string ≤128>`	Obligatorio. Reutilízalo solo para reintentar la misma solicitud.

Cuerpo de la solicitud

Campo	Tipo	Obligatorio	Notas
`model`	`string`	obligatorio	Slug del modelo en el catálogo.
`input`	`object`	obligatorio	Campos del esquema de entrada del modelo.
`expectedPriceMicros`	`integer`	opcional	Precio que mostraste al usuario. Si no coincide, se devuelve 409 PRICE_CHANGED antes de cualquier cargo.

campos de input

Los campos desconocidos se rechazan con INVALID_MODEL_INPUT.

Campo	Tipo	Obligatorio	Predeterminado	Valores permitidos y restricciones
`imageUrls`	`string[]`	obligatorio	—	Input images (1-3), ordered by array position. Public URLs, OSS temporary URLs, and Base64 are supported. Recommended size: 384-2048px, max 10MB per image. ≤ 3 items · HTTPS image URL or media:<uuid>
`prompt`	`string`	obligatorio	—	Image editing instruction describing what to preserve, replace, redraw, or enhance. Chinese and English are supported. ≤ 3000 chars
`negativePrompt`	`string`	opcional	—	Negative prompt describing unwanted content. ≤ 600 chars
`size`	`string`	opcional	—	Output resolution as widthheight. Total pixels must be within 512512 to 20482048. Labels 1k/2k denote resolution tier. Leave empty to let the model choose from the prompt. Uno de: `"10241024"`, `"16001600"`, `"7681152"`, `"12801920"`, `"1152768"`, `"19201280"`, `"7681024"`, `"15362048"`, `"1024768"`, `"17921344"`, `"5761024"`, `"11522048"`, `"1024576"`, `"20481152"` 262144–4194304 pixels; widthheight · Aspect ratio 1:8–8:1
`imageNum`	`integer`	opcional	`1`	Number of images generated per request. Defaults to 1. Uno de: `1`, `2`, `3`, `4`, `5`, `6`
`promptExtend`	`boolean`	opcional	`true`	Whether to enable intelligent prompt rewriting. Enabled by default; improves results for short editing instructions.
`promptExtendMode`	`string`	opcional	`"direct"`	Prompt rewriting mode, effective only when promptExtend is enabled. Use direct for direct rewriting or agent for agent-based rewriting. Uno de: `"direct"`, `"agent"`
`enableThinking`	`boolean`	opcional	`true`	Enable thinking mode for prompt rewriting. On by default: better quality, slower. Turn off to cut rewrite time to about 20s. Only takes effect when promptExtend=true. Supported for Direct I2I; not supported when promptExtendMode=agent.
`seed`	`integer`	opcional	—	Random seed in [0, 2147483647]. Fixing the seed reproduces results; leave empty for random. 0–2147483647

Respuesta

202 para una tarea nueva, 200 cuando coincide una repetición con Idempotency-Key. GET /api/v1/jobs/{id} devuelve la misma estructura sin replayed.

Campo	Tipo	Notas
`id`	`string`	ID de tarea de Hermes AI. Úsalo para consultar.
`model`	`string`	Slug del modelo.
`status`	`string`	Consulta los estados de la tarea.
`errorCode`	`string \| null`	Se establece cuando una tarea falla o requiere revisión.
`priceMicros`	`integer`	Cotización fijada al aceptarla, en micro-unidades de USD.
`currency`	`"USD"`
`createdAt / updatedAt`	`string`	Marcas de tiempo ISO 8601.
`assets[]`	`array`	{ id, type, url?, text? }. url es un enlace /api/v1/results/<uuid> del mismo origen.
`replayed`	`boolean`	Solo al enviar. true cuando coincide un reintento idempotente.

Estados de la tarea

Estado	Final	Significado
`queued`	no	Aceptada y a la espera de un trabajador.
`submitting`	no	Enviándose al proveedor del modelo.
`running`	no	El modelo está generando.
`succeeded`	sí	Terminada. Los resultados están en assets.
`failed`	sí	Terminada sin resultado. La reserva se libera.
`reconciliation_required`	sí	The result is being verified. Keep the task ID and do not resubmit automatically.

Errores

Todos los cuerpos de error son { code, error }. Gestiónalos por code.

HTTP	Código	Significado y acción
`401`	`AUTH_REQUIRED`	Falta la clave de API o la sesión, o no es válida.
`403`	`INSUFFICIENT_SCOPE`	La clave de API no tiene el permiso que necesita este endpoint.
`403`	`PERMISSION_DENIED`	Esta credencial no puede realizar la operación.
`429`	`API_KEY_RATE_LIMITED`	Se alcanzó el límite de frecuencia de la clave de API. Respeta Retry-After.
`429`	`API_KEY_USAGE_EXCEEDED`	La clave de API alcanzó su límite de uso. Crea una clave nueva.
`400`	`INVALID_REQUEST`	El cuerpo no es un objeto JSON o falta un valor obligatorio.
`400`	`INVALID_IDEMPOTENCY_KEY`	Idempotency-Key debe tener entre 1 y 128 caracteres ASCII imprimibles.
`400`	`INVALID_MODEL_INPUT`	input no coincide con el esquema del modelo (campo desconocido, campo obligatorio ausente o valor no válido).
`400 / 413`	`INPUT_TOO_LARGE`	El cuerpo de la solicitud supera los 256 KB. Sube primero los archivos multimedia y envía una referencia.
`404`	`REQUEST_NOT_FOUND`	No chat request with this ID belongs to your account.
`404`	`MODEL_NOT_FOUND`	Ningún modelo tiene este slug.
`404`	`JOB_NOT_FOUND`	Ninguna tarea con este ID pertenece a tu cuenta.
`409`	`IDEMPOTENCY_CONFLICT`	Esta Idempotency-Key se usó con otra entrada. Usa una clave nueva para una solicitud nueva.
`409`	`PRICE_CHANGED`	El precio difiere de expectedPriceMicros. Obtén el precio y vuelve a confirmarlo.
`409`	`MODEL_PRICE_UNAVAILABLE`	Este modelo aún no tiene precio configurado, por lo que no puede ejecutarse.
`409`	`PAYMENT_REVIEW_REQUIRED`	A refund left an uncovered balance. Contact support or cover the balance before submitting tasks.
`409`	`INSUFFICIENT_CREDITS`	Los créditos disponibles no cubren el precio de la tarea.
`429`	`RATE_LIMITED`	Demasiados envíos de tareas por minuto. Vuelve a intentarlo más tarde.
`429`	`CONCURRENCY_LIMITED`	Demasiadas tareas sin terminar. Espera a que termine alguna.
`503`	`EXECUTION_UNAVAILABLE`	La ejecución no está configurada para este modelo en este momento.
`429`	`UPSTREAM_RATE_LIMITED`	The model provider is rate limiting chat requests. Retry with backoff; nothing was charged.
`502`	`UPSTREAM_ERROR`	The model provider failed the chat request. Nothing was charged; retry later.
`503`	`PLATFORM_BUDGET_EXCEEDED`	This model is temporarily unavailable. Try again later.
`503`	`EXECUTION_TEMPORARILY_UNAVAILABLE`	La ejecución no está disponible temporalmente. Reintenta con la misma Idempotency-Key.
`503`	`AUTH_UNAVAILABLE`	La autenticación no está disponible temporalmente. Vuelve a intentarlo más tarde.
`503`	`API_UNAVAILABLE`	La API no está disponible temporalmente. Vuelve a intentarlo más tarde.

Guía completa de la API · OpenAPI 3.1

Precio de Hermes AI

Cargando precio…

Precio de lista oficial

Tarifas estándar de API del fabricante en USD, antes de descuentos de canal. Las unidades y especificaciones siguen la fuente oficial.

Precio oficial no verificado para este modelo.

Qué influye en el coste

Resolution, duration and output quantity can affect the quote. Review the rate card and the Playground quote before submitting.

· Only successful tasks are charged. Failed tasks release reserved credits; tasks with an unconfirmed outcome keep their reservation until the result is verified.
· Los reintentos idempotentes con la misma clave no generan un segundo cargo.
· Envía expectedPriceMicros para rechazar la tarea con PRICE_CHANGED si el precio cambió después de mostrarlo.

Estimación

Select the specifications in Playground to see the task quote.

// Facturación

Cómo funciona la facturación

Tasks use prepaid credits. Add credits on the Billing page; your balance updates after payment confirmation.

Cuándo	Efecto
Task accepted	The quoted amount is reserved from your balance.
Task succeeded	The final amount is charged once and any unused reservation is returned.
Task failed	The reserved amount is returned to your available balance.

Tasks with an unconfirmed outcome keep their reserved credits until the result is verified. Keep the task ID and contact support if you need help.

Payment refunds are reflected in your balance and transaction history on the Billing page.

Solicitud mínima

Solo campos obligatorios, generada a partir del esquema de este modelo. Define HERMES_API_KEY en tu entorno.

# 1. Submit the task (asynchronous; returns 202 with a task id)
curl -X POST https://api.hermes-ai.net/api/v1/jobs \
  -H "Authorization: Bearer $HERMES_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "qwen-image-3-0-pro-image-edit",
  "input": {
    "imageUrls": [
      "https://example.com/input.png"
    ],
    "prompt": "A lighthouse on a rocky coast at sunrise, soft light"
  }
}'

# 2. Poll until status is succeeded, failed or reconciliation_required
curl https://api.hermes-ai.net/api/v1/jobs/TASK_ID \
  -H "Authorization: Bearer $HERMES_API_KEY"

Con los valores predeterminados documentados

La misma solicitud con cada valor predeterminado opcional escrito, para que veas qué cambiar.

# 1. Submit the task (asynchronous; returns 202 with a task id)
curl -X POST https://api.hermes-ai.net/api/v1/jobs \
  -H "Authorization: Bearer $HERMES_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "qwen-image-3-0-pro-image-edit",
  "input": {
    "imageUrls": [
      "https://example.com/input.png"
    ],
    "prompt": "A lighthouse on a rocky coast at sunrise, soft light",
    "imageNum": 1,
    "promptExtend": true,
    "promptExtendMode": "direct",
    "enableThinking": true
  }
}'

# 2. Poll until status is succeeded, failed or reconciliation_required
curl https://api.hermes-ai.net/api/v1/jobs/TASK_ID \
  -H "Authorization: Bearer $HERMES_API_KEY"

Sube primero un archivo local

Sustituye la URL de ejemplo por la referencia multimedia devuelta.

POST /api/v1/media

curl -X POST https://api.hermes-ai.net/api/v1/media \
  -H "Authorization: Bearer $HERMES_API_KEY" \
  -H "Content-Type: image/png" \
  --data-binary @input.png
# → { "reference": "media:<uuid>", ... }  Use the reference in an image, video or audio field.