Saltar al contenido

Documentos para desarrolladores UlazAI

Imagen API

PUBLICAR /api/v1/generate/

Punto final de generación de imágenes canónicas

Utilice este punto final para todas las integraciones nuevas. Elige un modelo con model y opcionalmente pasar image_urls para editar flujos de trabajo en modelos compatibles.

Estado de la encuesta con /api/v1/generate/{generation_id}/ y usar /api/v1/generate/history/ para el historial laboral.

Solicitar contrato

campo Tipo Requerido Notas
prompt cuerda si 1 a 5000 caracteres
model cuerda No El valor predeterminado es gpt_image_15
size cuerda No Los valores permitidos dependen del modelo seleccionado. gpt_image_2 también acepta proporciones personalizadas como 5:7 o 1024x768.
quality cuerda No Modo de resolución o calidad, específico del modelo
image_urls matriz [cadena] No* Se utiliza para editar flujos de trabajo en modelos como gpt_image_2, qwen_image, y wan_2_7_image. Requerido para ideogram_character.

Selector de modelo

Cambie los ajustes preestablecidos del modelo para actualizar los ejemplos de solicitudes al instante.

Seedream 5.0 Lite model=seedream_5_lite

Multimodal reasoning model with text-to-image and image editing.

Tamaños permitidos: 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9

Valores de calidad permitidos: basic, high

Modo de edición: apoyado

Fragmentos de solicitud en vivo

Los fragmentos a continuación siguen el modelo preestablecido seleccionado.

rizo

JavaScript (buscar)

Python (solicitudes)

Ejemplos de respuesta

201 creado

{
  "success": true,
  "data": {
    "generation_id": "5a6be42f-4f01-4e80-9e16-8105315f0e62",
    "status": "processing",
    "estimated_time": "varies by model and queue",
    "credits_used": 8,
    "credits_remaining": 124,
    "message": "Generation started successfully"
  }
}

402 Pago requerido

{
  "success": false,
  "error": "Insufficient credits. Need 18, have 7",
  "credits_needed": 18,
  "credits_balance": 7
}

400 Solicitud incorrecta

{
  "success": false,
  "error": "Invalid size. Must be one of: 1:1, 3:2, 2:3"
}