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-seedance-4-5",
    "prompt": "A cute panda playing in a bamboo forest",
    "size": "1:1",
    "resolution": "2K",
    "n": 1,
    "image_urls": [
      "https://cdn.apimart.ai/doc/1761215838466614297_9852.png"
    ]
  }'

{
  "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-seedance-4-5",
    "prompt": "A cute panda playing in a bamboo forest",
    "size": "1:1",
    "resolution": "2K",
    "n": 1,
    "image_urls": [
      "https://cdn.apimart.ai/doc/1761215838466614297_9852.png"
    ]
  }'

{
  "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-seedance-4-5"
requerido
Nombre del modelo de generación de imágenesModelos admitidos: doubao-seedance-4-5, Doubao-Seedream-4.5, doubao-seedream-4.5, doubao-seedream-4-5Ejemplo: "doubao-seedance-4-5"
​
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
  • 9:21 - Ultravertical
  • auto - Ajusta automáticamente la proporción según la imagen de referencia (requiere image_urls)
​
resolution
string
predeterminado:"2K"
Resolución de la imagenResoluciones admitidas:
  • 2K - Resolución estándar (predeterminada)
  • 4K - Alta definición
Nota: Seedream-4.5 no admite la resolución 1K
Tamaños de referencia por resolución:
ResoluciónTamaño 1:1Tamaño 16:9
2K2048x20482560x1440
4K4096x40965404x3040
​
n
integer
Número de imágenes a generarRango: 1-15 (mínimo 1, máximo 15)Predeterminado: 1Nota:
  • El número real de imágenes que se pueden generar depende tanto de este parámetro como de la cantidad de imágenes de referencia enviadas. El total de imágenes de referencia + imágenes generadas debe ser ≤ 15
  • 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 image-to-image o edición de imágenesSe 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,{base64 data}
  • Formatos de imagen admitidos: jpeg, png
  • Ejemplo: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • Nota: el prefijo data:image/jpeg;base64, es obligatorio
Límites:
  • Máximo 10 imágenes
  • 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
  • Píxeles totales: no superar 6000×6000 px
​
optimize_prompt_options.mode
string
predeterminado:"standard"
Modo de optimización del prompt
  • standard: modo estándar, genera contenido de mayor calidad con mayor tiempo de procesamiento
  • fast: modo rápido, genera contenido en menos tiempo con calidad regular
Predeterminado: standard
​
sequential_image_generation
string
predeterminado:"disabled"
Modo de generación secuencial de imágenes (función específica de Doubao)Controla si se generan múltiples imágenes:
  • disabled: desactiva el modo secuencial; genera solo 1 imagen aunque haya varias referencias (predeterminado)
  • auto: activa el modo secuencial; permite generar múltiples imágenes
Notas de uso:
  • ✅ Debe proporcionar image_urls: se requiere al menos 1 imagen de referencia
  • ✅ Establezca n: 3 o use sequential_image_generation: "auto" + max_images: 3
  • ✅ Esto generará 3 imágenes distintas a partir de las imágenes de referencia
  • ⚠️ Cuando n > 1, se configurará automáticamente como auto
Limitaciones:
  • El text-to-image puro (sin image_urls) no puede generar múltiples imágenes: es una limitación de la API de Doubao
​
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, rango: 1-15
Ejemplo:
"sequential_image_generation": "auto",
"sequential_image_generation_options": {
  "max_images": 3
}
​
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