Текст в изображение

POST /v3/generation/text-to-image

Создайте изображение из текстовой подсказки.

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

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

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

Тело запроса

Параметр	Тип	Требуется	По умолчанию	Описание
prompt	строка	Да	-	Текстовое приглашение, до 1024 символов.
model	строка	Нет	`seedream_v4`	Модель изображения. Поддерживаемые значения: `seedream_v5`, `seedream_v4`, `gemini-2.5-flash`, `gemini-3-pro`, `gemini-3.1-flash`, `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/text-to-image \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "prompt": "A cat wearing a spacesuit, cyberpunk style",
    "model": "seedream-v4"
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/generation/text-to-image"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "prompt": "A cat wearing a spacesuit, cyberpunk style",
    "model": "seedream-v4"
}

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

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

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    prompt: "A cat wearing a spacesuit, cyberpunk style",
    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	2008	Ввод нарушает политику в отношении контента	Пересмотрите запрос и удалите описания, нарушающие правила.
403	2010	Недостаточно кредитов	Добавьте кредиты и повторите попытку.
400	2015	Версия модели устарела	Обновите `model` до поддерживаемой на данный момент версии.