Saltar al contenido principal
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedream-5-0-lite",
    "prompt": "A golden retriever playing in a garden, sunny day, high-definition photography style",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedream-5-0-lite",
    "prompt": "A golden retriever playing in a garden, sunny day, high-definition photography style",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

​
Autorización

​
Authorization
string
requerido
Todos los endpoints de la API requieren autenticación mediante Bearer TokenObtenga su clave de API:Visite la página de gestión de claves de API para obtener su clave de APIAñádala a la cabecera de la solicitud:
Authorization: Bearer YOUR_API_KEY

​
Cuerpo de la solicitud

​
model
string
predeterminado:"doubao-seedream-5-0-lite"
requerido
Nombre del modelo de generación de imágenesModelos admitidos: doubao-seedream-5-0-lite, doubao-seedream-5.0-lite, Doubao-Seedream-5.0-liteEjemplo: "doubao-seedream-5-0-lite"
​
prompt
string
requerido
Descripción textual para la generación de la imagen
​
size
string
predeterminado:"1:1"
Proporción de la imagenProporciones admitidas:
  • 1:1 - Cuadrado (predeterminado)
  • 4:3 - Horizontal 4:3
  • 3:4 - Vertical 3:4
  • 16:9 - Panorámico horizontal
  • 9:16 - Vertical alargado
  • 3:2 - Horizontal 3:2
  • 2:3 - Vertical 2:3
  • 21:9 - Ultrapanorámico
  • auto - Ajusta automáticamente la proporción según la imagen de referencia (requiere image_urls)
Nota: Seedream-5.0-Lite no admite la proporción 9:21
​
resolution
string
predeterminado:"2K"
Resolución de la imagenResoluciones admitidas:
  • 2K - Resolución estándar (predeterminada)
  • 3K - Alta definición
Nota: Seedream-5.0-Lite solo admite las resoluciones 2K y 3K; no se admiten 1K ni 4K
Tamaños de referencia por resolución:
ResoluciónTamaño 1:1Tamaño 16:9
2K2048x20482848x1600
3K3072x30724096x2304
​
n
integer
Número de imágenes a generarRango: 1-4Predeterminado: 1Nota:
  • Cuando n > 1, se activa automáticamente el modo de generación secuencial de imágenes
  • Debe indicar un número simple (por ejemplo, 1); no use comillas o se producirá un error
El cobro se descontará por adelantado según la cantidad
​
image_urls
array
Lista de URL de imágenes de referencia para la generación image-to-imageSe admiten dos formatos:1. URL completa de la imagen
  • URL de imagen de acceso público (http:// o https://)
  • Ejemplo: https://example.com/image.jpg
2. Formato codificado en Base64
  • Es obligatorio usar el formato Data URI completo
  • Formato: data:image/{format};base64,{base64data}
  • Formatos de imagen admitidos: jpeg, png
  • Ejemplo: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • ⚠️ Nota: el prefijo data:image/jpeg;base64, es obligatorio
Limitaciones:
  • Formatos de imagen: jpeg, png
  • Rango de proporción (ancho/alto): [1/3, 3]
  • Ancho y alto (px) > 14
  • Tamaño: no superar los 10MB por imagen
  • Píxeles totales: no superar 6000×6000 px
​
output_format
string
predeterminado:"jpeg"
Formato de salida de la imagen
  • jpeg: formato JPEG (predeterminado)
  • png: formato PNG, adecuado para fondos transparentes y casos similares
Nota: El parámetro output_format es exclusivo de Seedream-5.0-Lite. Otros modelos de imagen ignorarán este parámetro.
​
sequential_image_generation
string
predeterminado:"disabled"
Modo de generación secuencial de imágenesControla si se generan múltiples imágenes:
  • disabled: desactiva el modo secuencial (predeterminado)
  • auto: activa el modo secuencial; permite generar múltiples imágenes
Notas de uso:
  • Cuando n > 1, se configurará automáticamente como auto
​
sequential_image_generation_options
object
Opciones de generación secuencial de imágenesDisponible cuando sequential_image_generation se establece como autoPropiedades:
  • max_images (integer): especifica el número de imágenes a generar
Ejemplo:
"sequential_image_generation": "auto",
"sequential_image_generation_options": {
  "max_images": 4
}
​
watermark
boolean
predeterminado:"false"
Indica si debe añadirse una marca de agua a la imagen generada
  • true: añadir marca de agua
  • false: sin marca de agua (predeterminado)

​
Respuesta

​
code
integer
Código de estado de la respuesta
​
data
array
Array de datos de la respuesta