Tripo 3.1

Протоколы и возможности

generations

Режимы и параметры

text · text-to-3d

Промпт: required; предел символов: 4000.

Параметр	Назначение	По умолчанию	Допустимые значения
`texture`	Текстура	`true`	`{ "required": true }`
`pbr`	PBR-материалы	`true`	`{ "required": true }`
`texture_quality`	Качество текстуры	`"standard"`	`{ "required": true, "values": [ "standard", "detailed" ] }`
`geometry_quality`	Качество геометрии	`"standard"`	`{ "required": true, "values": [ "standard", "detailed" ] }`
`quad`	Четырёхугольная сетка	`false`	`{ "required": true }`
`real_scale`	Реальный масштаб	`false`	`{ "required": true }`
`polycount`	Число полигонов	`null`	`{ "required": false, "min": 1000, "max": 2000000 }`
`seed`	Зерно	`-1`	`{ "required": false, "min": -1, "max": 2147483647, "step": 1 }`
`negative_prompt`	Исключить из кадра	`null`	`{ "required": false }`

image · image-to-3d

Промпт: hidden; предел символов: 4000.

Параметр	Назначение	По умолчанию	Допустимые значения
`texture`	Текстура	`true`	`{ "required": true }`
`pbr`	PBR-материалы	`true`	`{ "required": true }`
`texture_quality`	Качество текстуры	`"standard"`	`{ "required": true, "values": [ "standard", "detailed" ] }`
`geometry_quality`	Качество геометрии	`"standard"`	`{ "required": true, "values": [ "standard", "detailed" ] }`
`quad`	Четырёхугольная сетка	`false`	`{ "required": true }`
`real_scale`	Реальный масштаб	`false`	`{ "required": true }`
`polycount`	Число полигонов	`null`	`{ "required": false, "min": 1000, "max": 2000000 }`
`seed`	Зерно	`-1`	`{ "required": false, "min": -1, "max": 2147483647, "step": 1 }`
`texture_alignment`	Привязка текстуры	`"original_image"`	`{ "required": true, "values": [ "original_image", "geometry" ] }`
`orientation`	Ориентация	`"default"`	`{ "required": true, "values": [ "default", "align_image" ] }`

Входные файлы

Параметр	Назначение	По умолчанию	Допустимые значения
`source_image`	Изображение	—	`{ "media_kind": "image", "required": true, "min_items": 1, "max_items": 1, "collection": false, "ordered": false, "accept": [ "image/png", "image/jpeg", "image/webp" ], "max_bytes": 20971520 }`

Совместимость настроек

json

[
  {
    "allowed": {
      "pbr": [
        false
      ]
    },
    "fallback": {
      "pbr": false
    },
    "when": {
      "texture": false
    }
  }
]

Расчёт стоимости

Цена зависит от выбранных настроек и входных файлов. Калькулятор рассчитывает стоимость без генерации. Для расчёта с файлами используйте POST /v1/generations/quote с API-ключом. Тариф и параметры фиксируются при создании задачи.

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

bash

curl "${RENDERFOX_BASE_URL:-https://api.renderfox.ru/v1}/generations" \
  -H "Authorization: Bearer $RENDERFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  --data-binary @request.json

json

{
  "model": "tripo-3.1",
  "mode": "text",
  "prompt": "Создай результат по этому описанию.",
  "settings": {
    "texture": true,
    "pbr": true,
    "texture_quality": "standard",
    "geometry_quality": "standard",
    "quad": false,
    "real_scale": false,
    "seed": -1
  },
  "inputs": {}
}

Новый логический запрос — новый Idempotency-Key. Сетевой повтор использует прежние ключ и тело. Резерв, списание и возврат FC · Ошибки · Каталог.

Версия тарифа: eee6f1d5e858ad46a5195c52d66a3f4b95985be56f1bb59bad4e2f0de4ac229e. Версия каталога: d12314f1d1fbe542. Последнее обновление источника: версия опубликованного каталога.