Перейти к содержимому

Hunyuan Image · v3 · Text to Image

Интеграция

ID модели hunyuan-image/v3/text-to-image
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/hunyuan-image/v3/text-to-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Этот запрос: 0,10 $ 100 API-кредитов · ≈ 10,76 ₽ Запустить на этой странице

Получить API-ключ
Tencent Текст в изображение #text-to-image

Hunyuan Image 3.0 преобразует текст в изображение с негативным промптом и повышенным значением guidance по умолчанию — 7.5

Tencent · Изображение

Здесь появится ваш первый результат

Составьте запрос ниже и выполните его с помощью API-ключа. Результаты копируются в наше хранилище и хранятся навсегда или 7 дней бесплатно.

Сформировать запрос

Элементы управления сгенерированы из схемы модели. Код и цена обновляются при изменении параметров.

•обязательно

Текстовый промпт для генерации изображения по изображению.

image_size по умолчанию square_hd

Целевые размеры сгенерированного изображения.

num_images по умолчанию 1

Количество изображений, запрошенных для генерации.

Расширенные negative_prompt · output_format · num_inference_steps · guidance_scale · seed · enable_safety_checker · enable_prompt_expansion
по умолчанию

Концепции, которые следует исключить из сгенерированного изображения; передаются как негативный промпт.

output_format по умолчанию png

Формат файла итогового изображения.

по умолчанию 28

Количество шагов удаления шума.

по умолчанию 7.5

Степень следования промпту: увеличьте это значение, чтобы модель точнее следовала промпту.

Начальное значение для воспроизводимости; None позволяет системе выбрать случайное значение вместо использования заданного вызывающим кодом.

POST /run/hunyuan-image/v3/text-to-image?wait=20 стоимость → 0,10 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/hunyuan-image/v3/text-to-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Запустить этот запрос

Ваш ключ хранится в этом браузере: он отправляется только в Doitong API и сохраняется в localStorage только при включении параметра «Запомнить». Получить API-ключ

О Hunyuan Image · v3 · Text to Image

Создаёт изображения по `prompt` и необязательному `negative_prompt`. По умолчанию используется 28 шагов (максимум 50) и `guidance_scale` 7.5. `enable_prompt_expansion` по умолчанию отключён; при включении языковая модель добавляет детали. Возвращает от 1 до 4 изображений в формате png или jpeg.

Параметры

Передавайте либо каноническое имя, либо исходное имя, но не оба. Канонические имена

ИмяТип По умолчаниюДопустимые значения Описание
promptобязательно
Типstring
Текстовый промпт для генерации изображения по изображению.
negative_promptнеобязательно
Типstring
По умолчанию
Концепции, которые следует исключить из сгенерированного изображения; передаются как негативный промпт.
image_sizeнеобязательно
Типobject
По умолчаниюsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Целевые размеры сгенерированного изображения.
num_imagesнеобязательно num_outputs
Типinteger
По умолчанию1
1 – 4
Количество изображений, запрошенных для генерации.
num_inference_stepsнеобязательно
Типinteger
По умолчанию28
1 – 50
Количество шагов удаления шума.
guidance_scaleнеобязательно
Типnumber
По умолчанию7.5
1 – 20
Степень следования промпту: увеличьте это значение, чтобы модель точнее следовала промпту.
seedнеобязательно
Типinteger | null
Начальное значение для воспроизводимости; None позволяет системе выбрать случайное значение вместо использования заданного вызывающим кодом.
enable_safety_checkerнеобязательно
Типboolean
По умолчаниюtrue
Переключатель проверки безопасности, отключение которого требует авторизации учётной записи. Без такой авторизации каждый запрос проверяется независимо от настройки; значение true включает проверку.
output_formatнеобязательно
Типenum
По умолчаниюpng
jpegpng
Формат файла итогового изображения.
enable_prompt_expansionнеобязательно
Типboolean
По умолчаниюfalse
Разрешает большой языковой модели дополнить промпт деталями. Это расширение не меняет смысл промпта.
обязательно Каноническое имя, также принимается

Результат

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan-image/v3/text-to-image",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 100,
    "usd": "0.10",
    "charged": 100,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "seed": 42
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Ваши файлы — ваш выборКаждый URL из outputs[].url — это копия в нашем хранилище: она хранится навсегда (оплата за ГБ в месяц) или 7 дней бесплатно — в зависимости от настройки вашего аккаунта или параметра ?storage=.
Одинаковая структура у каждой моделиtype, url, content_type, width, height и duration — одинаково для изображений, видео и аудио. output — собственный объект результата модели.
Поля результата
images
array of object {url, content_type, file_name, file_size, width, height}Список, содержащий сгенерированные изображения.
seed
integerБазовое начальное значение, использованное во время генерации.

Для AI-агентов: эта страница в формате Markdown доступна по адресу https://doitong.com/developers/models/hunyuan-image/v3/text-to-image.md. Все модели и руководства: https://doitong.com/developers/llms.txt