Przejdź do treści

Hunyuan Image · v3 · Instruct · Edit

Integracja

Identyfikator modelu hunyuan-image/v3/instruct/edit
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hunyuan-image/v3/instruct/edit?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",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

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

To żądanie: ≈0,174 $ 174 kredyty API Uruchom na tej stronie

Uzyskaj klucz API
Tencent Edycja obrazów #tencent#hunyuan-image#instruct#edit

Edycja obrazów na podstawie instrukcji i do 3 obrazów referencyjnych, z opcjonalnym rozwijaniem promptu

Tencent · Obraz

Tutaj pojawi się pierwszy wynik

Zbuduj poniżej żądanie i uruchom je za pomocą klucza API. Wyniki są kopiowane do naszej przestrzeni dyskowej i przechowywane bezterminowo lub 7 dni bezpłatnie.

Zbuduj żądanie

Elementy sterujące są generowane ze schematu modelu. Kod i cena aktualizują się podczas ich zmiany.

•wymagane

Instrukcje tekstowe używane do wygenerowania obrazu.

•wymagane image_urls
Upuść plik lub

Podaj referencje generowania jako adresy URL; lista może zawierać maksymalnie 3 obrazy.

image_size domyślnie auto

Wymiary wynikowego obrazu, jawnie określone lub wybrane przez model po ustawieniu auto.

num_images domyślnie 1

Liczba obrazów żądanych do wygenerowania.

Zaawansowane output_format · guidance_scale · seed · enable_prompt_expansion · enable_safety_checker
output_format domyślnie png

Format pliku wynikowego obrazu.

domyślnie 3.5

Siła stosowania się do promptu: zwiększ tę wartość, aby model ściślej wykonywał prompt.

Ziarno zapewniające powtarzalność; None pozwala systemowi wybrać je losowo zamiast używać wartości podanej przez wywołującego.

POST /run/hunyuan-image/v3/instruct/edit?wait=20 wycena → 0,174 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hunyuan-image/v3/instruct/edit?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",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

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

Uruchom to żądanie

Klucz pozostaje w tej przeglądarce: jest wysyłany tylko do Doitong API i zapisywany (localStorage) tylko po zaznaczeniu opcji Zapamiętaj. Uzyskaj klucz API

Informacje o Hunyuan Image · v3 · Instruct · Edit

Edytuje obrazy zgodnie z tekstowym `prompt`, używając od jednego do trzech obrazów referencyjnych w `image_urls`. `image_size` domyślnie przyjmuje auto, więc model wybiera rozmiar wyjściowy. Można zwrócić do 4 obrazów, `guidance_scale` mieści się w zakresie od 1 do 20, a rozwijanie promptu jest domyślnie włączone. Wynik to png lub jpeg.

Parametry

Wyślij nazwę kanoniczną albo natywną, nie obie. Nazwy kanoniczne

NazwaTyp DomyślneDozwolone Opis
promptwymagane
Typstring
Instrukcje tekstowe używane do wygenerowania obrazu.
image_sizeopcjonalne
Typobject
Domyślneauto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Wymiary wynikowego obrazu, jawnie określone lub wybrane przez model po ustawieniu auto.
num_imagesopcjonalne num_outputs
Typinteger
Domyślne1
1 – 4
Liczba obrazów żądanych do wygenerowania.
guidance_scaleopcjonalne
Typnumber
Domyślne3.5
≤ 20> 1
Siła stosowania się do promptu: zwiększ tę wartość, aby model ściślej wykonywał prompt.
enable_prompt_expansionopcjonalne
Typboolean
Domyślnetrue
Rozszerzanie promptu przez wewnętrzne ponowne opisywanie obrazu przez model, włączane po ustawieniu true.
seedopcjonalne
Typinteger | null
Ziarno zapewniające powtarzalność; None pozwala systemowi wybrać je losowo zamiast używać wartości podanej przez wywołującego.
enable_safety_checkeropcjonalne
Typboolean
Domyślnetrue
Aktywacja kontroli bezpieczeństwa; true włącza kontrolę.
output_formatopcjonalne
Typenum
Domyślnepng
jpegpng
Format pliku wynikowego obrazu.
image_urlswymagane images
Typurl[] · image
Podaj referencje generowania jako adresy URL; lista może zawierać maksymalnie 3 obrazy.
wymagane Nazwa kanoniczna, również akceptowana

Parametry plików przyjmują publiczny URL https://, identyfikator URI data: do 10 MB albo file_url przesłanego pliku. Pliki

Wynik

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan-image/v3/instruct/edit",
  "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": 174,
    "usd": "0.174",
    "charged": 174,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Twoje pliki, Twój wybórKażdy outputs[].url to kopia w naszej przestrzeni dyskowej: przechowywana bezterminowo (opłata za GB-miesiąc) lub 7 dni bezpłatnie, zgodnie z ustawieniem konta lub ?storage=.
Taki sam format w każdym modelutype, url, content_type, width, height i duration — tak samo dla obrazów, filmów i dźwięku. output to własny obiekt wyniku modelu.
Pola wyniku
images
array of object {url, content_type, file_name, file_size, width, height}Lista zawierająca wygenerowane obrazy.
seed
integerBazowe ziarno używane podczas generowania.

Więcej modeli: Edycja obrazów

Dla agentów AI: ta strona w formacie Markdown jest dostępna pod adresem https://doitong.com/pl/developers/models/hunyuan-image/v3/instruct/edit.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt