Изображение к изображению

POST /v3/generation/image-to-image

Создайте новое изображение из эталонного изображения.

Параметры запроса

Заголовки запросов

Параметр	Тип	Требуется	По умолчанию	Описание
Content-Type	строка	Да	-	`application/json`
Authorization	строка	Да	-	`Bearer {api_key}`

Тело запроса

Параметр	Тип	Требуется	По умолчанию	Описание
input	строка	Да	-	Справочное изображение. Поддерживает `file_token`, изображение URL или `task_id`.
inputs	строка[]	Нет	-	Список нескольких эталонных изображений. Модели `seedream` поддерживают до 4 изображений, а модели `banana` — до 10 изображений. Вы можете ссылаться на определенное изображение в `prompt`, используя `[image number]`.
prompt	строка	Условно требуется	-	Инструкция по редактированию изображений. Требуется, если `template` не указан.
model	строка	Нет	`seedream_v5`	Модель изображения. Поддерживаемые значения: `seedream_v5`, `banana`, `banana_pro`, `banana2`, `chat_image_1`, `chat_image_1.5`, `chat_image_2`, `chat_image_2.5_flare`, `chat_image_2.5_sunburst`.
quality	строка	Нет	`low`	Уровень качества. Только `chat_image_2` (`low`, `medium`, `high`) и `chat_image_2.5_flare` / `chat_image_2.5_sunburst` (дополнительно `xhigh`, `max`). Без указания равно `low`; `auto` не поддерживается. `high`/`xhigh`/`max` стоят больше кредитов.
background	строка	Нет	-	Обработка фона. Только `chat_image_2.5_flare` / `chat_image_2.5_sunburst`: `auto`, `opaque`, `transparent`. С другими моделями значение игнорируется, а не отклоняется. `transparent` требует `output_format=png` (JPEG не поддерживает альфа-канал).
template	строка	Нет	-	Имя шаблона. Поддерживаемые значения: `asset_extraction`, `character_completion`, `t_pose`, `head_extraction`, `3d_enhance`, `variants`, `print_clay`, `figure`.
t_pose	логическое значение	Нет	`false`	Превратиться в Т-позу
sketch_to_render	логическое значение	Нет	`false`	Преобразование эскиза в визуализированное изображение

Примеры запросов

curl -X POST https://openapi.tripo3d.ai/v3/generation/image-to-image \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "input": "https://example.com/reference.png",
    "prompt": "Replace the background with a starry sky",
    "model": "seedream-v4"
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/generation/image-to-image"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "input": "https://example.com/reference.png",
    "prompt": "Replace the background with a starry sky",
    "model": "seedream-v4"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

const url = "https://openapi.tripo3d.ai/v3/generation/image-to-image";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    input: "https://example.com/reference.png",
    prompt: "Replace the background with a starry sky",
    model: "seedream-v4"
  })
});

const data = await response.json();
console.log(data);

Ответ

Успешный ответ

JSON

{
  "code": 0,
  "data": {
    "task_id": "task_abc123"
  }
}

Поля ответа

Параметр	Тип	Описание
code	целое число	Код состояния. `0` указывает на успех.
data.task_id	строка	Уникальный идентификатор задачи, используемый для запроса хода создания и результатов.

Коды ошибок

HTTP Код состояния	Код ошибки	Описание	Рекомендация
429	2000	Превышен лимит генерации	Уменьшите частоту запросов и повторите попытку позже.
400	2002	Неподдерживаемый параметр запроса	Проверьте имена параметров тела запроса и диапазоны значений.
400	2003	Входной файл пуст	Убедитесь, что `input` указывает на действительный ресурс изображения.
400	2004	Неподдерживаемый тип файла	Используйте поддерживаемый формат изображения (PNG, JPEG, WebP)
400	2008	Ввод нарушает политику в отношении контента	Измените входное изображение или запрос и удалите описания, нарушающие правила.
403	2010	Недостаточно кредитов	Добавьте кредиты и повторите попытку.
400	2015	Версия модели устарела	Обновите `model` до поддерживаемой на данный момент версии.