Saltar al contenido

API de Mage · Modelo de imagen

API de HiDream

Rápida y versátil, con prompts negativos

POST https://api.mage.space/v1/hidream/generate

De un vistazo

La API de HiDream ejecuta HiDream a través de Mage en POST https://api.mage.space/v1/hidream/generate. Una solicitud con la configuración predeterminada cuesta 20 Gems (unos 0,02 $), sin suscripción. HiDream no admite menciones con @handle.

  • ImagenResultado
  • 1Variante
  • 20Gems por imagen, por defecto
  • $0.02Aprox., en USD

Resumen

Qué hace la API de HiDream

Un modelo general de texto a imagen, rápido y con prompt negativo. Ideal para prompts del día a día, fotorrealistas o ilustrados.

Un modelo de imagen general y rápido con prompt negativo, fotorrealista o ilustrado.

Genera solo a partir del prompt.

Inicio rápido

Llama a la API de HiDream

Define MAGE_API_KEY, envía la solicitud a /hidream/generate y consulta status_url hasta que se complete.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/hidream/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "hidream-fast"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('hidream', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'hidream-fast',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("hidream", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "hidream-fast",
})

print(request["result"]["url"])

Modelos

Valores de model_id de HiDream

Envía model_id para elegir una variante. Si no lo incluyes, se usa la predeterminada.

model_idNombrePredeterminado
hidream-fastHiDreamSí

Opciones

Parámetros de HiDream

Valores permitidos en todas las variantes; una variante puede ofrecer menos. La documentación indica las opciones de cada variante.

CampoValores
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21

Más modelos de imagen

Otras API de generación de imágenes en Mage

Preguntas frecuentes

Preguntas frecuentes

¿Cuánto cuesta la API de HiDream?
Una solicitud de HiDream con la configuración predeterminada (HiDream) cuesta 20 Gems, unos 0,02 $. Otras resoluciones, duraciones y variantes cambian el precio; la respuesta indica el cargo exacto. Si una generación falla, se reembolsa; si la bloquea la política de contenido de Mage, no.
¿Cuál es el endpoint de la API de HiDream?
POST https://api.mage.space/v1/hidream/generate con un encabezado Authorization: Bearer que lleve tu clave de API de Mage. La respuesta incluye una status_url para consultar el resultado.
¿Qué modelos de HiDream puedo usar?
hidream-fast. El predeterminado es HiDream.
¿HiDream admite imágenes de referencia o personajes?
HiDream no admite entradas de imagen, vídeo ni audio. HiDream no admite menciones con @handle.
¿Puedo usar HiDream desde Claude o ChatGPT?
Sí. Conecta el servidor MCP de Mage a Claude, ChatGPT, Claude Code, Grok o Cursor y pide HiDream por su nombre. Tu asistente lee sus opciones con get_model y te indica el precio antes de generar.
¿Cuánto tiempo se conservan los resultados de HiDream?
Los resultados y las entradas se conservan durante 30 días. Descarga lo que quieras guardar en tu propio almacenamiento.

Empieza a crear con Mage

Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.

CharactersComunidad