Перейти к основному содержанию
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-0",
    "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-0",
    "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"
    }
  ]
}

​
Авторизация

​
Authorization
string
обязательно
Все конечные точки API требуют аутентификации Bearer TokenПолучите свой API Key:Перейдите на страницу управления API ключами, чтобы получить свой API KeyДобавьте его в заголовок запроса:
Authorization: Bearer YOUR_API_KEY

​
Тело запроса

​
model
string
по умолчанию:"doubao-seedance-4-0"
обязательно
Название модели генерации изображенийПоддерживаемые модели: doubao-seedance-4-0, doubao-seedream-4.0, doubao-seedream-4-0, Doubao-Seedream-4.0Пример: "doubao-seedance-4-0"
​
prompt
string
обязательно
Текстовое описание для генерации изображенияМаксимум 1000 символов
​
size
string
по умолчанию:"1:1"
Соотношение сторон изображенияПоддерживаемые соотношения сторон:
  • 1:1 — квадрат (по умолчанию)
  • 4:3 — горизонтальный 4:3
  • 3:4 — вертикальный 3:4
  • 16:9 — горизонтальный широкоформатный
  • 9:16 — вертикальный
  • 3:2 — горизонтальный 3:2
  • 2:3 — вертикальный 2:3
  • 21:9 — сверхширокий
  • 9:21 — сверхвысокий
  • auto — автоматически подбирать соотношение сторон по референсному изображению (требуется image_urls)
​
resolution
string
по умолчанию:"2K"
Разрешение изображенияПоддерживаемые разрешения:
  • 1K — базовое разрешение
  • 2K — стандартное разрешение (по умолчанию)
  • 4K — высокое разрешение
Справочные размеры для разрешений:
РазрешениеРазмер 1:1Размер 16:9
1K1024x10241280x720
2K2048x20482560x1440
4K4096x40965404x3040
​
n
integer
Количество генерируемых изображенийДиапазон: 1–15 (минимум 1, максимум 15)По умолчанию: 1Примечание:
  • Фактическое количество генерируемых изображений зависит как от этого параметра, так и от количества входных референсных изображений. Сумма референсных и генерируемых изображений должна быть ≤ 15
  • Необходимо указывать обычное число (например, 1), не используйте кавычки, иначе это вызовет ошибку
Списание будет произведено заранее на основе количества
​
image_urls
array
Список URL референсных изображений для image-to-image или редактированияПоддерживаются два формата:1. Полный URL изображения
  • Публично доступный URL изображения (http:// или https://)
  • Пример: https://example.com/image.jpg
2. Формат Base64
  • Необходимо использовать полный формат Data URI
  • Формат: data:image/{format};base64,{base64-data}
  • Поддерживаемые форматы изображений: jpeg, png
  • Пример: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • Внимание: префикс data:image/jpeg;base64, обязателен
Ограничения:
  • Максимум 10 изображений
  • Форматы изображений: jpeg, png
  • Диапазон соотношения сторон (ширина/высота): [1/3, 3]
  • Ширина и высота (px) > 14
  • Размер: не более 10MB
  • Общее количество пикселей: не более 6000×6000 px
​
optimize_prompt_options
string
по умолчанию:"standard"
Режим оптимизации промпта
  • standard: стандартный режим, генерирует более качественный контент с увеличенным временем обработки
  • fast: быстрый режим, генерирует контент за меньшее время с обычным качеством
По умолчанию: standard
​
sequential_image_generation
string
по умолчанию:"disabled"
Режим последовательной генерации изображений (специфическая функция Doubao)Управляет генерацией нескольких изображений:
  • disabled: отключить последовательный режим, генерирует только 1 изображение даже при наличии нескольких референсов (по умолчанию)
  • auto: включить последовательный режим, можно генерировать несколько изображений
Заметки по использованию:
  • Необходимо указать image_urls — требуется минимум 1 референсное изображение
  • Установите n: 3 или используйте sequential_image_generation: "auto" + max_images: 3
  • Будут сгенерированы 3 разных изображения на основе референсов
  • Когда n > 1, режим автоматически установится в auto
Ограничения:
  • Чистый text-to-image (без image_urls) не может генерировать несколько изображений — это ограничение Doubao API
​
sequential_image_generation_options
object
Параметры последовательной генерации изображенийДоступно, когда sequential_image_generation установлено в autoСвойства:
  • max_images (integer): задаёт количество генерируемых изображений, диапазон: 1–15
Пример:
"sequential_image_generation": "auto",
"sequential_image_generation_options": {
  "max_images": 3
}
​
watermark
boolean
по умолчанию:"false"
Добавлять ли водяной знак к сгенерированному изображению
  • true: добавить водяной знак
  • false: без водяного знака (по умолчанию)

​
Ответ

​
code
integer
Код состояния ответа
​
data
array
Массив данных ответа